FRED — Get Regional Economic Data

Retrieve Regional Economic Data with the FRED API. Supply a file type, a series group and a region type and optionally set a start date. Build a market research view or track changes over time. The GET request schema also lists file_type, series_group, region_type.

Selected price
$0 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
A key or file extension that indicates the type of file to send. One of the following values: 'xml', 'json' xml = Extensible Markup Language. The HTTP Content-Type is text/xml (xml is not available for county data). json = JavaScript Object Notation. The HTTP Content-Type is application/json. OpenAny import profile requires json explicitly; original XML/download formats remain in official documentation.
The ID for a group of series found in FRED. string, required
The region you want to pull data for. string, required One of the following values: bea msa frb necta state country county censusregion
The date you want to pull a series group data from. YYYY-MM-DD formatted string, required
The seasonality of the series group. string, required, five possible SA (Seasonally Adjusted), NSA (Not Seasonally Adjusted), SSA (Smoothed Seasonally Adjusted), SAAR (Seasonally Adjusted Annual Rate), or NSAAR (Not Seasonally Adjusted Annual Rate)
The units of the series you want to pull. string, required
Optional parameters (4)
The start date you want to request series group data from. This allows you to pull a range of data YYYY-MM-DD formatted string, optional
A key that indicates a data value transformation. string, optional, default: lin (No transformation) One of the following values: 'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log' lin = Levels (No transformation) chg = Change ch1 = Change from Year Ago pch = Percent Change pc1 = Percent Change from Year Ago pca = Compounded Annual Rate of Change cch = Continuously Compounded Rate of Change cca = Continuously Compounded Annual Rate of Change log = Natural Log For unit transformation formulas, see: https://alfred.stlouisfed.org/help#growth_formulas
Frequency automatically assigns the default frequency of the map when using the Request Wizard above. The parameter can be used as a frequency aggregation feature. The maps frequency aggregation feature converts higher frequency data series into lower frequency data series (e.g. converts a monthly data series into an annual data series). In maps, the highest frequency data is daily, and the lowest frequency data is annual. There are 3 aggregation methods available- average, sum, and end of period. See the aggregation_method parameter. string One of the following values: 'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem' Frequencies without period descriptions: d = Daily w = Weekly bw = Biweekly m = Monthly q = Quarterly sa = Semiannual a = Annual Frequencies with period descriptions: wef = Weekly, Ending Friday weth = Weekly, Ending Thursday wew = Weekly, Ending Wednesday wetu = Weekly, Ending Tuesday wem = Weekly, Ending Monday wesu = Weekly, Ending Sunday wesa = Weekly, Ending Saturday bwew = Biweekly, Ending Wednesday bwem = Biweekly, Ending Monday
string, optional, default: avg One of the following values: 'avg', 'sum', 'eop' avg = Average sum = Sum eop = End of Period

Sample response

{
  "2013 Per Capita Personal Income by State (Dollars)": {
    "2013": [
      {
        "code": "01",
        "region": "Alabama",
        "series_id": "ALPCPI",
        "value": "36481"
      },
      {
        "code": "02",
        "region": "Alaska",
        "series_id": "AKPCPI",
        "value": "50150"
      },
      {
        "code": "04",
        "region": "Arizona",
        "series_id": "AZPCPI",
        "value": "36983"
      },
      {
        "code": "05",
        "region": "Arkansas",
        "series_id": "ARPCPI",
        "value": "36698"
      },
      {
        "code": "06",
        "region": "California",
        "series_id": "CAPCPI",
        "value": "48434"
      },
      {
        "code": "08",
        "region": "Colorado",
        "series_id": "COPCPI",
        "value": "46897"
      },
      {
        "code": "09",
        "region": "Connecticut",
        "series_id": "CTPCPI",
        "value": "60658"
      },
      {
        "code": "10",
        "region": "Delaware",
        "series_id": "DEPCPI",
        "value": "44815"
      },
      {
        "code": "11",
        "region": "District of Columbia",
        "series_id": "DCPCPI",
        "value": "75329"
      },
      {
        "code": "12",
        "region": "Florida",
        "series_id": "FLPCPI",
        "value": "41497"
      },
      {
        "code": "13",
        "region": "Georgia",
        "series_id": "GAPCPI",
        "value": "37845"
      },
      {
        "code": "15",
        "region": "Hawaii",
        "series_id": "HIPCPI",
        "value": "45204"
      },
      {
        "code": "16",
        "region": "Idaho",
        "series_id": "IDPCPI",
        "value": "36146"
      },
      {
        "code": "17",
        "region": "Illinois",
        "series_id": "ILPCPI",
        "value": "46980"
      },
      {
        "code": "18",
        "region": "Indiana",
        "series_id": "INPCPI",
        "value": "38622"
      },
      {
        "code": "19",
        "region": "Iowa",
        "series_id": "IAPCPI",
        "value": "44763"
      },
      {
        "code": "20",
        "region": "Kansas",
        "series_id": "KSPCPI",
        "value": "44417"
      },
      {
        "code": "21",
        "region": "Kentucky",
        "series_id": "KYPCPI",
        "value": "36214"
      },
      {
        "code": "22",
        "region": "Louisiana",
        "series_id": "LAPCPI",
        "value": "41204"
      },
      {
        "code": "23",
        "region": "Maine",
        "series_id": "MEPCPI",
        "value": "40924"
      },
      {
        "code": "24",
        "region": "Maryland",
        "series_id": "MDPCPI",
        "value": "53826"
      },
      {
        "code": "25",
        "region": "Massachusetts",
        "series_id": "MAPCPI",
        "value": "57248"
      },
      {
        "code": "26",
        "region": "Michigan",
        "series_id": "MIPCPI",
        "value": "39055"
      },
      {
        "code": "27",
        "region": "Minnesota",
        "series_id": "MNPCPI",
        "value": "47500"
      },
      {
        "code": "28",
        "region": "Mississippi",
        "series_id": "MSPCPI",
        "value": "33913"
      },
      {
        "code": "29",
        "region": "Missouri",
        "series_id": "MOPCPI",
        "value": "40663"
      },
      {
        "code": "30",
        "region": "Montana",
        "series_id": "MTPCPI",
        "value": "39366"
      },
      {
        "code": "31",
        "region": "Nebraska",
        "series_id": "NEPCPI",
        "value": "47157"
      },
      {
        "code": "32",
        "region": "Nevada",
        "series_id": "NVPCPI",
        "value": "39235"
      },
      {
        "code": "33",
        "region": "New Hampshire",
        "series_id": "NHPCPI",
        "value": "51013"
      },
      {
        "code": "34",
        "region": "New Jersey",
        "series_id": "NJPCPI",
        "value": "55386"
      },
      {
        "code": "35",
        "region": "New Mexico",
        "series_id": "NMPCPI",
        "value": "35965"
      },
      {
        "code": "36",
        "region": "New York",
        "series_id": "NYPCPI",
        "value": "54462"
      },
      {
        "code": "37",
        "region": "North Carolina",
        "series_id": "NCPCPI",
        "value": "38683"
      },
      {
        "code": "38",
        "region": "North Dakota",
        "series_id": "NDPCPI",
        "value": "53182"
      },
      {
        "code": "39",
        "region": "Ohio",
        "series_id": "OHPCPI",
        "value": "41049"
      },
      {
        "code": "40",
        "region": "Oklahoma",
        "series_id": "OKPCPI",
        "value": "41861"
      },
      {
        "code": "41",
        "region": "Oregon",
        "series_id": "ORPCPI",
        "value": "39848"
      },
      {
        "code": "42",
        "region": "Pennsylvania",
        "series_id": "PAPCPI",
        "value": "46202"
      },
      {
        "code": "44",
        "region": "Rhode Island",
        "series_id": "RIPCPI",
        "value": "46989"
      },
      {
        "code": "45",
        "region": "South Carolina",
        "series_id": "SCPCPI",
        "value": "35831"
      },
      {
        "code": "46",
        "region": "South Dakota",
        "series_id": "SDPCPI",
        "value": "46039"
      },
      {
        "code": "47",
        "region": "Tennessee",
        "series_id": "TNPCPI",
        "value": "39558"
      },
      {
        "code": "48",
        "region": "Texas",
        "series_id": "TXPCPI",
        "value": "43862"
      },
      {
        "code": "49",
        "region": "Utah",
        "series_id": "UTPCPI",
        "value": "36640"
      },
      {
        "code": "50",
        "region": "Vermont",
        "series_id": "VTPCPI",
        "value": "45483"
      },
      {
        "code": "51",
        "region": "Virginia",
        "series_id": "VAPCPI",
        "value": "48838"
      },
      {
        "code": "53",
        "region": "Washington",
        "series_id": "WAPCPI",
        "value": "47717"
      },
      {
        "code": "54",
        "region": "West Virginia",
        "series_id": "WVPCPI",
        "value": "35533"
      },
      {
        "code": "55",
        "region": "Wisconsin",
        "series_id": "WIPCPI",
        "value": "43244"
      },
      {
        "code": "56",
        "region": "Wyoming",
        "series_id": "WYPCPI",
        "value": "52826"
      }
    ]
  }
}

Response result

Response structure

Inferred from examples
  • 2013 Per Capita Personal Income by State (Dollars)object
    • 2013object[]
      • codestring
      • regionstring
      • series_idstring
      • valuestring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use FRED — Get Regional Economic Data with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.