The Bureau of Economic Analysis · Example Payload

The Bureau Of Economic Analysis Getregionaldata Example

EconomicsFederal-GovernmentGDPNational AccountsOpen DataStatistics

The Bureau Of Economic Analysis Getregionaldata Example is an example object payload from The Bureau of Economic Analysis, with 2 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse

Example Payload

Raw ↑
{
  "request": {
    "method": "GET",
    "url": "https://apps.bea.gov/api/data/?UserID=YOUR_API_KEY&method=GetData&DatasetName=Regional&TableName=SQGDP1&LineCode=1&GeoFips=STATE&Year=2023,2024&ResultFormat=JSON",
    "parameters": {
      "UserID": "YOUR_API_KEY",
      "method": "GetData",
      "DatasetName": "Regional",
      "TableName": "SQGDP1",
      "LineCode": 1,
      "GeoFips": "STATE",
      "Year": "2023,2024",
      "ResultFormat": "JSON"
    }
  },
  "response": {
    "BEAAPI": {
      "Request": {
        "RequestParam": [
          { "ParameterName": "UserID", "ParameterValue": "YOUR_API_KEY" },
          { "ParameterName": "METHOD", "ParameterValue": "GETDATA" },
          { "ParameterName": "DATASETNAME", "ParameterValue": "Regional" },
          { "ParameterName": "TableName", "ParameterValue": "SQGDP1" },
          { "ParameterName": "LineCode", "ParameterValue": "1" },
          { "ParameterName": "GeoFips", "ParameterValue": "STATE" },
          { "ParameterName": "Year", "ParameterValue": "2023,2024" },
          { "ParameterName": "RESULTFORMAT", "ParameterValue": "JSON" }
        ]
      },
      "Results": {
        "Statistic": "SQGDP1-Real GDP by state",
        "UnitOfMeasure": "Millions of chained 2017 dollars",
        "PublicTable": "SQGDP1 Real GDP by state",
        "UTCProductionTime": "2025-03-27T10:00:00.000",
        "Dimensions": [
          { "Name": "TableName", "DataType": "string", "IsValue": "0" },
          { "Name": "GeoFips", "DataType": "string", "IsValue": "0" },
          { "Name": "GeoName", "DataType": "string", "IsValue": "0" },
          { "Name": "LineCode", "DataType": "numeric", "IsValue": "0" },
          { "Name": "IndustryId", "DataType": "numeric", "IsValue": "0" },
          { "Name": "IndustryClassification", "DataType": "string", "IsValue": "0" },
          { "Name": "Description", "DataType": "string", "IsValue": "0" },
          { "Name": "TimePeriod", "DataType": "string", "IsValue": "0" },
          { "Name": "CL_UNIT", "DataType": "string", "IsValue": "0" },
          { "Name": "MULT", "DataType": "numeric", "IsValue": "0" },
          { "Name": "DataValue", "DataType": "numeric", "IsValue": "1" },
          { "Name": "NoteRef", "DataType": "string", "IsValue": "0" }
        ],
        "Data": [
          {
            "GeoFips": "06000",
            "GeoName": "California",
            "LineCode": "1",
            "IndustryId": "1",
            "IndustryClassification": "...",
            "Description": "All industry total",
            "TimePeriod": "2024Q1",
            "CL_UNIT": "Millions of chained 2017 dollars",
            "MULT": "6",
            "DataValue": "3,421,517",
            "NoteRef": ""
          },
          {
            "GeoFips": "48000",
            "GeoName": "Texas",
            "LineCode": "1",
            "IndustryId": "1",
            "IndustryClassification": "...",
            "Description": "All industry total",
            "TimePeriod": "2024Q1",
            "CL_UNIT": "Millions of chained 2017 dollars",
            "MULT": "6",
            "DataValue": "2,192,845",
            "NoteRef": ""
          }
        ]
      }
    }
  }
}