FRED GeoFRED Regional Data

Name: FRED GeoFRED Regional Data
Price: 0.000015 USD
Availability: InStock
Author: FRED

https://api.sandbase.ai/v1/api/fred/geo-regional-data

GeoFRED Regional Data from FRED. Returns the official FRED API response unchanged.

Try this API Get API key

Price: $0USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 6 required · 4 optional

Production route

Try the model

Playground

Open playground

Input

Aggregation Method(string)

string, optional, default: avg One of the following values: 'avg', 'sum', 'eop' avg = Average sum = Sum eop = End of Period avg = Average sum = Sum eop = End of Period Allowed values: avg, sum, eop.

Date(string)

The date you want to pull a series group data from. YYYY-MM-DD formatted string, required

File Type(string)

Response format. Only json is supported. Allowed values: json.

Frequency(string)

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 d Allowed values: d, w, bw, m, q, sa, a, wef, weth, wew, wetu, wem, wesu, wesa, bwew, bwem.

Region Type(string)

The region you want to pull data for. string, required One of the following values: bea msa frb necta state country county censusregion bea msa frb necta state country county censusregion Allowed values: bea, msa, frb, necta, state, country, county, censusregion.

Season(string)

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)

Series Group(string)

The ID for a group of series found in FRED. string, required

Start Date(string)

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

Transformation(string)

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 Allowed values: lin, chg, ch1, pch, pc1, pca, cch, cca, log.

Units(string)

The units of the series you want to pull. string, required

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $0 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

date: string · required
frequency: string (d, w, bw, m, q, sa, a, wef, weth, wew, wetu, wem, wesu, wesa, bwew, bwem) · required
region_type: string (bea, msa, frb, necta, state, country, county, censusregion) · required
season: string · required
series_group: string · required
units: string · required
aggregation_method: string (avg, sum, eop) · optional
file_type: string (json) · optional
start_date: string · optional
transformation: string (lin, chg, ch1, pch, pc1, pca, cch, cca, log) · optional

Access

Provider: FRED
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/fred/geo-regional-data
Authentication: Bearer API key

API README

FRED GeoFRED Regional Data API

GeoFRED Regional Data from FRED. Returns the official FRED API response unchanged.

The response is the official FRED API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "fred/geo-regional-data", "date": "<date>", "frequency": "<frequency>", "region_type": "<region_type>", "season": "<season>", "series_group": "<series_group>", "units": "<units>"}'

Parameters

Name	Type	Required	Description
`aggregation_method`	string	No	string, optional, default: avg One of the following values: 'avg', 'sum', 'eop' avg = Average sum = Sum eop = End of Period avg = Average sum = Sum eop = End of
`date`	string	Yes	The date you want to pull a series group data from. YYYY-MM-DD formatted string, required
`file_type`	string	No	Response format. Only json is supported.
`frequency`	string	Yes	Frequency automatically assigns the default frequency of the map when using the Request Wizard above. The parameter can be used as a frequency aggregation featu
`region_type`	string	Yes	The region you want to pull data for. string, required One of the following values: bea msa frb necta state country county censusregion bea msa frb necta state
`season`	string	Yes	The seasonality of the series group. string, required, five possible SA (Seasonally Adjusted), NSA (Not Seasonally Adjusted), SSA (Smoothed Seasonally Adjusted)
`series_group`	string	Yes	The ID for a group of series found in FRED. string, required
`start_date`	string	No	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
`transformation`	string	No	A key that indicates a data value transformation. string, optional, default: lin (No transformation) One of the following values: 'lin', 'chg', 'ch1', 'pch', 'p
`units`	string	Yes	The units of the series you want to pull. string, required

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/fred/geo-regional-data

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/fred/geo-regional-data" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "file_type": "json",
  "transformation": "lin",
  "aggregation_method": "avg"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
FRED GeoFRED Regional DataThis API `FRED`	$0 per call	JSON	Oct 30, 2026
FRED category `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Children `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Related `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Related Tags `FRED`	$0 per call	JSON	Oct 30, 2026
FRED Get Category Series `FRED`	$0 per call	JSON	Oct 30, 2026

Questions

FAQ

How do I use the FRED GeoFRED Regional Data API?

Send a POST request to https://api.sandbase.ai/v1/api/fred/geo-regional-data with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the FRED GeoFRED Regional Data API cost?

$0 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the FRED GeoFRED Regional Data API accept?

Required: date (string), frequency (one of d, w, bw, m, q, sa, a, wef, weth, wew, wetu, wem, wesu, wesa, bwew, bwem), region_type (one of bea, msa, frb, necta, state, country, county, censusregion), season (string), series_group (string) and units (string). Optional: aggregation_method (one of avg, sum, eop), file_type (one of json), start_date (string) and transformation (one of lin, chg, ch1, pch, pc1, pca, cch, cca, log). The Parameters table and the Playground on this page list every field.

What does the FRED GeoFRED Regional Data API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a FRED developer account or API key?

No. FRED GeoFRED Regional Data runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for FRED API access separately.