Bea

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

6 endpoints424 calls6/6 passing
Get API key
GET/v1/…bea/regional
passing · 3.0s1d cache

Try it

Checking your keys…

Parameters

archive

string · query · optional

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 · optional

Table inside the archive, when it holds more than one. Default the first.

geo

string · query · optional

Two-letter state code for the per-state file, or ALL_AREAS for every area in one. Default ALL_AREAS.

area

string · query · optional

Case-insensitive filter over the area name and FIPS code.

line

number · query · optional

Only the rows carrying this LineCode — 1 is total personal income in most tables.

from

string · query · optional

Earliest period — a year for annual archives, 2020Q1 for quarterly ones.

to

string · query · optional

Latest period, same format as `from`.

length

number · query · optional

Rows to return. Default 100, max 2000.

Example response

{"project":"finance:bea",  "data": {"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"          }        ],"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"          }        ],"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"          }        ],"geoFips":"00000","geoName":"United States","lineCode":3,"description":"Per capita personal income (dollars) 2/","latestValue":73204,"latestPeriod":"2024","industryClassification":"..."      }    ],"table":"CAINC1","total":9627,    "tables": [      "CAINC1"    ],"archive":"CAINC1","dataset":"regional",    "periods": [      "1969",      "1970",      "1971"    ],"provider":"bea"  },"timestamp":"2026-08-21T02:22:43Z"}

Errors

  • 401Missing or invalid x-api-key
  • 404Not found or private
  • 429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:bea",  "regional",  { archive: "CAINC1", table: "SQINC1", geo: "WA", area: "Seattle", line: 1, from: "2020", to: "2024", length: 50 });