# Bea — Zapi reference

> BEA regional income — state and county personal income, from the bulk zips.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/bea
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Bea

**Category:** finance · **Slug:** `bea`
**Detail page:** https://zpi.web.id/api/finance/bea

BEA regional income — state and county personal income, from the bulk zips.

**Tags:** finance, bea

### Regional

BEA regional income — state and county personal income, from the bulk zips.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:bea/regional`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `archive` | string | query | no | Regional dataset archive — CAINC1 (annual county and state personal income), sqinc (quarterly state income), CAINC4, CAINC30 and the rest of the CA/SA/SQ family. Default CAINC1. |
| `table` | string | query | no | Table inside the archive, when it holds more than one. Default the first. |
| `geo` | string | query | no | Two-letter state code for the per-state file, or ALL_AREAS for every area in one. Default ALL_AREAS. |
| `area` | string | query | no | Case-insensitive filter over the area name and FIPS code. |
| `line` | number | query | no | Only the rows carrying this LineCode — 1 is total personal income in most tables. |
| `from` | string | query | no | Earliest period — a year for annual archives, 2020Q1 for quarterly ones. |
| `to` | string | query | no | Latest period, same format as `from`. |
| `length` | number | query | no | Rows to return. Default 100, max 2000. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:bea/regional?archive=CAINC1&table=SQINC1&geo=WA&area=Seattle&line=1&from=2020&to=2024&length=50" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:bea/regional?archive=CAINC1&table=SQINC1&geo=WA&area=Seattle&line=1&from=2020&to=2024&length=50", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:bea/regional?archive=CAINC1&table=SQINC1&geo=WA&area=Seattle&line=1&from=2020&to=2024&length=50",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "geo": "ALL_AREAS",
  "area": null,
  "from": null,
  "line": null,
  "count": 100,
  "entry": "CAINC1__ALL_AREAS_1969_2024.csv",
  "items": [
    {
      "unit": "Thousands of dollars",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 24897613000,
          "period": "2024"
        },
        {
          "value": 23577208000,
          "period": "2023"
        },
        {
          "value": 22144814000,
          "period": "2022"
        },
        {
          "value": 21484168000,
          "period": "2021"
        },
        {
          "value": 19613059000,
          "period": "2020"
        },
        {
          "value": 18349584000,
          "period": "2019"
        },
        {
          "value": 17514402000,
          "period": "2018"
        },
        {
          "value": 16658962000,
          "period": "2017"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 1,
      "description": "Personal income (thousands of dollars)",
      "latestValue": 24897613000,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Number of persons",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 340110988,
          "period": "2024"
        },
        {
          "value": 336806231,
          "period": "2023"
        },
        {
          "value": 334017321,
          "period": "2022"
        },
        {
          "value": 332099760,
          "period": "2021"
        },
        {
          "value": 331577720,
          "period": "2020"
        },
        {
          "value": 330226227,
          "period": "2019"
        },
        {
          "value": 328529577,
          "period": "2018"
        },
        {
          "value": 326608609,
          "period": "2017"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 2,
      "description": "Population (persons) 1/",
      "latestValue": 340110988,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Dollars",
      "count": 56,
      "table": "CAINC1",
      "region": null,
      "values": [
        {
          "value": 73204,
          "period": "2024"
        },
        {
          "value": 70002,
          "period": "2023"
        },
        {
          "value": 66298,
          "period": "2022"
        },
        {
          "value": 64692,
          "period": "2021"
        },
        {
          "value": 59151,
          "period": "2020"
        },
        {
          "value": 55567,
          "period": "2019"
        },
        {
          "value": 53311,
          "period": "2018"
        },
        {
          "value": 51006,
          "period": "2017"
        }
      ],
      "geoFips": "00000",
      "geoName": "United States",
      "lineCode": 3,
      "description": "Per capita personal income (dollars) 2/",
      "latestValue": 73204,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Thousands of dollars",
      "count": 56,
      "table": "CAINC1",
      "region": "5",
      "values": [
        {
          "value": 295590485,
          "period": "2024"
        },
        {
          "value": 279484602,
          "period": "2023"
        },
        {
          "value": 262425794,
          "period": "2022"
        },
        {
          "value": 255682271,
          "period": "2021"
        },
        {
          "value": 230878360,
          "period": "2020"
        },
        {
          "value": 215151792,
          "period": "2019"
        },
        {
          "value": 205674190,
          "period": "2018"
        },
        {
          "value": 197963769,
          "period": "2017"
        }
      ],
      "geoFips": "01000",
      "geoName": "Alabama",
      "lineCode": 1,
      "description": "Personal income (thousands of dollars)",
      "latestValue": 295590485,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Number of persons",
      "count": 56,
      "table": "CAINC1",
      "region": "5",
      "values": [
        {
          "value": 5157699,
          "period": "2024"
        },
        {
          "value": 5117673,
          "period": "2023"
        },
        {
          "value": 5076181,
          "period": "2022"
        },
        {
          "value": 5049196,
          "period": "2021"
        },
        {
          "value": 5033094,
          "period": "2020"
        },
        {
          "value": 5003778,
          "period": "2019"
        },
        {
          "value": 4977088,
          "period": "2018"
        },
        {
          "value": 4953096,
          "period": "2017"
        }
      ],
      "geoFips": "01000",
      "geoName": "Alabama",
      "lineCode": 2,
      "description": "Population (persons) 1/",
      "latestValue": 5157699,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Dollars",
      "count": 56,
      "table": "CAINC1",
      "region": "5",
      "values": [
        {
          "value": 57311,
          "period": "2024"
        },
        {
          "value": 54612,
          "period": "2023"
        },
        {
          "value": 51697,
          "period": "2022"
        },
        {
          "value": 50638,
          "period": "2021"
        },
        {
          "value": 45872,
          "period": "2020"
        },
        {
          "value": 42998,
          "period": "2019"
        },
        {
          "value": 41324,
          "period": "2018"
        },
        {
          "value": 39968,
          "period": "2017"
        }
      ],
      "geoFips": "01000",
      "geoName": "Alabama",
      "lineCode": 3,
      "description": "Per capita personal income (dollars) 2/",
      "latestValue": 57311,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Thousands of dollars",
      "count": 56,
      "table": "CAINC1",
      "region": "5",
      "values": [
        {
          "value": 3424189,
          "period": "2024"
        },
        {
          "value": 3202452,
          "period": "2023"
        },
        {
          "value": 2979576,
          "period": "2022"
        },
        {
          "value": 2915364,
          "period": "2021"
        },
        {
          "value": 2656173,
          "period": "2020"
        },
        {
          "value": 2477876,
          "period": "2019"
        },
        {
          "value": 2371211,
          "period": "2018"
        },
        {
          "value": 2290351,
          "period": "2017"
        }
      ],
      "geoFips": "01001",
      "geoName": "Autauga, AL",
      "lineCode": 1,
      "description": "Personal income (thousands of dollars)",
      "latestValue": 3424189,
      "latestPeriod": "2024",
      "industryClassification": "..."
    },
    {
      "unit": "Number of persons",
      "count": 56,
      "table": "CAINC1",
      "region": "5",
      "values": [
        {
          "value": 61464,
          "period": "2024"
        },
        {
          "value": 60436,
          "period": "2023"
        },
        {
          "value": 59736,
          "period": "2022"
        },
        {
          "value": 59191,
          "period": "2021"
        },
        {
          "value": 58909,
          "period": "2020"
        },
        {
          "value": 58251,
          "period": "2019"
        },
        {
          "value": 57747,
          "period": "2018"
        },
        {
          "value": 57393,
          "period": "2017"
        }
      ],
      "geoFips": "01001",
      "geoName": "Autauga, AL",
      "lineCode": 2,
      "description": "Population (persons) 1/",
      "latestValue": 61464,
      "latestPeriod": "2024",
      "industryClassification": "..."
    }
  ],
  "table": "CAINC1",
  "total": 9627,
  "tables": [
    "CAINC1"
  ],
  "archive": "CAINC1",
  "dataset": "regional",
  "periods": [
    "1969",
    "1970",
    "1971",
    "1972",
    "1973",
    "1974",
    "1975",
    "1976"
  ],
  "provider": "bea"
}
```

---

### Series

The BEA's NIPA series register — 10,781 series with their labels, metrics and

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:bea/series`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Case-insensitive filter over the series code, label and metric. |
| `series` | string | query | no | Exact series codes, comma-separated. Overrides `query`. |
| `table` | string | query | no | Only series that appear on this table. |
| `metric` | string | query | no | Only series whose metric matches, case-insensitive substring. |
| `length` | number | query | no | Series to return. Default 100, max 2000. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:bea/series?query=gross%20domestic%20product&series=A191RL%2CA191RC&table=T10101&metric=Current%20Dollars&length=50" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:bea/series?query=gross%20domestic%20product&series=A191RL%2CA191RC&table=T10101&metric=Current%20Dollars&length=50", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:bea/series?query=gross%20domestic%20product&series=A191RL%2CA191RC&table=T10101&metric=Current%20Dollars&length=50",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 46,
  "items": [
    {
      "label": "Gross domestic product",
      "metric": "Fisher Quantity Index",
      "series": "A191RA",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10103"
        },
        {
          "line": 1,
          "table": "T10203"
        },
        {
          "line": 1,
          "table": "T10303"
        },
        {
          "line": 1,
          "table": "T10403"
        },
        {
          "line": 1,
          "table": "T10503"
        },
        {
          "line": 1,
          "table": "T10703"
        },
        {
          "line": 1,
          "table": "T10803"
        }
      ],
      "calculation": "Level",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product",
      "metric": "Current Dollars",
      "series": "A191RC",
      "parents": [
        "A001RC",
        "A712RC",
        "A962RC",
        "BB00RC",
        "Y695RC"
      ],
      "appearsOn": [
        {
          "line": 1,
          "table": "OECD10205"
        },
        {
          "line": 1,
          "table": "T10105"
        },
        {
          "line": 1,
          "table": "T10205"
        },
        {
          "line": 1,
          "table": "T10305"
        },
        {
          "line": 1,
          "table": "T10405"
        },
        {
          "line": 1,
          "table": "T10505"
        },
        {
          "line": 1,
          "table": "T10705"
        },
        {
          "line": 1,
          "table": "T11705"
        }
      ],
      "calculation": "Level",
      "defaultScale": -6
    },
    {
      "label": "Gross domestic product",
      "metric": "Chained Dollar IPDs",
      "series": "A191RD",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10109"
        }
      ],
      "calculation": "Level",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product",
      "metric": "Current Dollar Shares",
      "series": "A191RE",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10110"
        }
      ],
      "calculation": "Level",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product",
      "metric": "Fisher Price Index",
      "series": "A191RG",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10104"
        },
        {
          "line": 1,
          "table": "T10204"
        },
        {
          "line": 1,
          "table": "T10304"
        },
        {
          "line": 1,
          "table": "T10404"
        },
        {
          "line": 1,
          "table": "T10504"
        },
        {
          "line": 59,
          "table": "T10604"
        },
        {
          "line": 1,
          "table": "T10704"
        }
      ],
      "calculation": "Level",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product",
      "metric": "Chained Dollar IPDs",
      "series": "A191RI",
      "parents": [],
      "appearsOn": [
        {
          "line": 28,
          "table": "T10107"
        }
      ],
      "calculation": "Percent change, annual rate",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product",
      "metric": "Fisher Quantity Index",
      "series": "A191RL",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10101"
        },
        {
          "line": 1,
          "table": "T10102"
        },
        {
          "line": 1,
          "table": "T10201"
        },
        {
          "line": 1,
          "table": "T10202"
        },
        {
          "line": 1,
          "table": "T10301"
        },
        {
          "line": 1,
          "table": "T10401"
        },
        {
          "line": 1,
          "table": "T10501"
        },
        {
          "line": 1,
          "table": "T10502"
        }
      ],
      "calculation": "Percent change, annual rate",
      "defaultScale": 0
    },
    {
      "label": "Gross domestic product (GDP)",
      "metric": "Fisher Quantity Index",
      "series": "A191RO",
      "parents": [],
      "appearsOn": [
        {
          "line": 1,
          "table": "T10111"
        }
      ],
      "calculation": "Percent change, year ago",
      "defaultScale": 0
    }
  ],
  "query": "gross domestic product",
  "table": null,
  "total": 46,
  "metric": null,
  "series": null,
  "dataset": "series",
  "provider": "bea",
  "registered": 10781
}
```

---

### Gdp

US gross domestic product — the GDP cut of the NIPA flat files.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:bea/gdp`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `measure` | enum(level|change|contribution) | query | no | Which cut: level, change, contribution. Default change. |
| `frequency` | enum(A|Q|M) | query | no | A annual, Q quarterly, M monthly. Default Q. Contributions and chained dollars are quarterly and annual only. |
| `from` | string | query | no | Earliest period in the file's own format — 2020 for annual, 2020Q1 for quarterly, 2020M01 for monthly. |
| `to` | string | query | no | Latest period, same format as `from`. |
| `length` | number | query | no | Observations per series, newest first. Default 40, max 20000. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:bea/gdp?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:bea/gdp?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:bea/gdp?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": null,
  "count": 3,
  "items": [
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 317,
      "metric": "Fisher Quantity Index",
      "series": "A191RL",
      "values": [
        {
          "value": 1.5,
          "period": "2026Q2"
        },
        {
          "value": 2.1,
          "period": "2026Q1"
        },
        {
          "value": 0.5,
          "period": "2025Q4"
        },
        {
          "value": 4.4,
          "period": "2025Q3"
        },
        {
          "value": 3.8,
          "period": "2025Q2"
        },
        {
          "value": -0.6,
          "period": "2025Q1"
        },
        {
          "value": 1.9,
          "period": "2024Q4"
        },
        {
          "value": 3.3,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 1.5,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Gross domestic product, current dollars",
      "total": 317,
      "metric": "Current Dollars",
      "series": "A191RP",
      "values": [
        {
          "value": 7.9,
          "period": "2026Q2"
        },
        {
          "value": 5.8,
          "period": "2026Q1"
        },
        {
          "value": 4.2,
          "period": "2025Q4"
        },
        {
          "value": 8.3,
          "period": "2025Q3"
        },
        {
          "value": 6,
          "period": "2025Q2"
        },
        {
          "value": 2.9,
          "period": "2025Q1"
        },
        {
          "value": 4.3,
          "period": "2024Q4"
        },
        {
          "value": 5.1,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 7.9,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 317,
      "metric": "Fisher Price Index",
      "series": "A191RV",
      "values": [
        {
          "value": 6.2,
          "period": "2026Q2"
        },
        {
          "value": 3.6,
          "period": "2026Q1"
        },
        {
          "value": 3.7,
          "period": "2025Q4"
        },
        {
          "value": 3.8,
          "period": "2025Q3"
        },
        {
          "value": 2.1,
          "period": "2025Q2"
        },
        {
          "value": 3.6,
          "period": "2025Q1"
        },
        {
          "value": 2.4,
          "period": "2024Q4"
        },
        {
          "value": 1.8,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 6.2,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    }
  ],
  "total": 951,
  "series": [
    "A191RL",
    "A191RP",
    "A191RV"
  ],
  "dataset": "gdp",
  "measure": "change",
  "missing": [],
  "provider": "bea",
  "resolved": [
    "A191RL",
    "A191RP",
    "A191RV"
  ],
  "frequency": "Q",
  "truncated": false
}
```

---

### Nipa

Dated observations for any NIPA series, from the BEA's flat files.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:bea/nipa`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `series` | string | query | no | NIPA series codes, comma-separated, up to 25. `series` and `tables` find them. Default A191RL (real GDP, percent change, annual rate). |
| `frequency` | enum(A|Q|M) | query | no | A annual, Q quarterly, M monthly. Default Q. Not every series exists at every frequency. |
| `from` | string | query | no | Earliest period in the file's own format — 2020 for annual, 2020Q1 for quarterly, 2020M01 for monthly. |
| `to` | string | query | no | Latest period, same format as `from`. |
| `length` | number | query | no | Observations per series, newest first. Default 40, max 20000. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:bea/nipa?series=A191RL%2CA191RC&frequency=Q&from=2020Q1&to=2026Q2&length=20" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:bea/nipa?series=A191RL%2CA191RC&frequency=Q&from=2020Q1&to=2026Q2&length=20", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:bea/nipa?series=A191RL%2CA191RC&frequency=Q&from=2020Q1&to=2026Q2&length=20",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": null,
  "count": 2,
  "items": [
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 317,
      "metric": "Fisher Quantity Index",
      "series": "A191RL",
      "values": [
        {
          "value": 1.5,
          "period": "2026Q2"
        },
        {
          "value": 2.1,
          "period": "2026Q1"
        },
        {
          "value": 0.5,
          "period": "2025Q4"
        },
        {
          "value": 4.4,
          "period": "2025Q3"
        },
        {
          "value": 3.8,
          "period": "2025Q2"
        },
        {
          "value": -0.6,
          "period": "2025Q1"
        },
        {
          "value": 1.9,
          "period": "2024Q4"
        },
        {
          "value": 3.3,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 1.5,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Gross domestic product",
      "total": 318,
      "metric": "Current Dollars",
      "series": "A191RC",
      "values": [
        {
          "value": 32475210,
          "period": "2026Q2"
        },
        {
          "value": 31865721,
          "period": "2026Q1"
        },
        {
          "value": 31422526,
          "period": "2025Q4"
        },
        {
          "value": 31098027,
          "period": "2025Q3"
        },
        {
          "value": 30485729,
          "period": "2025Q2"
        },
        {
          "value": 30042113,
          "period": "2025Q1"
        },
        {
          "value": 29825182,
          "period": "2024Q4"
        },
        {
          "value": 29511664,
          "period": "2024Q3"
        }
      ],
      "calculation": "Level",
      "latestValue": 32475210,
      "defaultScale": -6,
      "latestPeriod": "2026Q2"
    }
  ],
  "total": 635,
  "series": [
    "A191RL",
    "A191RC"
  ],
  "dataset": "nipa",
  "missing": [],
  "provider": "bea",
  "resolved": [
    "A191RL",
    "A191RC"
  ],
  "frequency": "Q",
  "truncated": false
}
```

---

### Tables

The BEA's NIPA table register — the table ids `series` joins against.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:bea/tables`
- **Cache TTL:** 86400s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `query` | string | query | no | Case-insensitive filter over the table id and title. |
| `length` | number | query | no | Tables to return. Default 200, max 1000. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:bea/tables?query=gross%20domestic%20product&length=50" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:bea/tables?query=gross%20domestic%20product&length=50", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:bea/tables?query=gross%20domestic%20product&length=50",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 45,
  "items": [
    {
      "table": "T10101",
      "title": "Table 1.1.1. Percent Change From Preceding Period in Real Gross Domestic Product"
    },
    {
      "table": "T10102",
      "title": "Table 1.1.2. Contributions to Percent Change in Real Gross Domestic Product"
    },
    {
      "table": "T10103",
      "title": "Table 1.1.3. Real Gross Domestic Product, Quantity Indexes"
    },
    {
      "table": "T10104",
      "title": "Table 1.1.4. Price Indexes for Gross Domestic Product"
    },
    {
      "table": "T10105",
      "title": "Table 1.1.5. Gross Domestic Product"
    },
    {
      "table": "T10106",
      "title": "Table 1.1.6. Real Gross Domestic Product, Chained Dollars"
    },
    {
      "table": "T10107",
      "title": "Table 1.1.7. Percent Change From Preceding Period in Prices for Gross Domestic Product"
    },
    {
      "table": "T10108",
      "title": "Table 1.1.8. Contributions to Percent Change in the Gross Domestic Product Price Index"
    }
  ],
  "query": "gross domestic product",
  "total": 45,
  "dataset": "tables",
  "provider": "bea"
}
```

---

### Pce

US personal consumption expenditures — the PCE cut of the NIPA flat files.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:bea/pce`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `measure` | enum(level|change|contribution) | query | no | Which cut: level, change, contribution. Default change. |
| `frequency` | enum(A|Q|M) | query | no | A annual, Q quarterly, M monthly. Default Q. Every PCE measure here is published at all three. |
| `from` | string | query | no | Earliest period in the file's own format — 2020 for annual, 2020Q1 for quarterly, 2020M01 for monthly. |
| `to` | string | query | no | Latest period, same format as `from`. |
| `length` | number | query | no | Observations per series, newest first. Default 40, max 20000. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:bea/pce?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:bea/pce?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:bea/pce?measure=change&frequency=Q&from=2020Q1&to=2026Q2&length=12",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "to": null,
  "from": null,
  "count": 3,
  "items": [
    {
      "count": 40,
      "label": "Personal consumption expenditures",
      "total": 317,
      "metric": "Fisher Quantity Index",
      "series": "DPCERL",
      "values": [
        {
          "value": 3.2,
          "period": "2026Q2"
        },
        {
          "value": 0.5,
          "period": "2026Q1"
        },
        {
          "value": 1.9,
          "period": "2025Q4"
        },
        {
          "value": 3.5,
          "period": "2025Q3"
        },
        {
          "value": 2.5,
          "period": "2025Q2"
        },
        {
          "value": 0.6,
          "period": "2025Q1"
        },
        {
          "value": 3.9,
          "period": "2024Q4"
        },
        {
          "value": 4,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 3.2,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Personal consumption expenditures",
      "total": 317,
      "metric": "Fisher Price Index",
      "series": "DPCERV",
      "values": [
        {
          "value": 5.1,
          "period": "2026Q2"
        },
        {
          "value": 4.6,
          "period": "2026Q1"
        },
        {
          "value": 2.9,
          "period": "2025Q4"
        },
        {
          "value": 2.8,
          "period": "2025Q3"
        },
        {
          "value": 2.1,
          "period": "2025Q2"
        },
        {
          "value": 3.4,
          "period": "2025Q1"
        },
        {
          "value": 2.5,
          "period": "2024Q4"
        },
        {
          "value": 1.7,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, annual rate",
      "latestValue": 5.1,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    },
    {
      "count": 40,
      "label": "Personal consumption expenditures (PCE)",
      "total": 314,
      "metric": "Fisher Quantity Index",
      "series": "DPCERO",
      "values": [
        {
          "value": 2.3,
          "period": "2026Q2"
        },
        {
          "value": 2.1,
          "period": "2026Q1"
        },
        {
          "value": 2.1,
          "period": "2025Q4"
        },
        {
          "value": 2.6,
          "period": "2025Q3"
        },
        {
          "value": 2.7,
          "period": "2025Q2"
        },
        {
          "value": 3.1,
          "period": "2025Q1"
        },
        {
          "value": 3.4,
          "period": "2024Q4"
        },
        {
          "value": 3.2,
          "period": "2024Q3"
        }
      ],
      "calculation": "Percent change, year ago",
      "latestValue": 2.3,
      "defaultScale": 0,
      "latestPeriod": "2026Q2"
    }
  ],
  "total": 948,
  "series": [
    "DPCERL",
    "DPCERV",
    "DPCERO"
  ],
  "dataset": "pce",
  "measure": "change",
  "missing": [],
  "provider": "bea",
  "resolved": [
    "DPCERL",
    "DPCERV",
    "DPCERO"
  ],
  "frequency": "Q",
  "truncated": false
}
```

---


_Generated: 2026-08-21T07:35:23.740Z_