FRED Get Series Observations

Name: FRED Get Series Observations
Price: 0.000015 USD
Availability: InStock
Author: FRED

https://api.sandbase.ai/v1/api/fred/series-observations

Get Series Observations 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: 1 required · 13 optional

Production route

Try the model

Playground

Open playground

Input

Aggregation Method(string)

A key that indicates the aggregation method used for frequency aggregation. This parameter has no affect if the frequency parameter is not set. 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 = En Allowed values: avg, sum, eop.

File Type(string)

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

Frequency(string)

An optional parameter that indicates a lower frequency to aggregate values to. The FRED 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 FRED, the highest frequency data is daily, Allowed values: d, w, bw, m, q, sa, a, wef, weth, wew, wetu, wem, wesu, wesa, bwew, bwem.

Limit(integer)

The maximum number of results to return. integer between 1 and 100000, optional, default: 100000 Range: 1 to 100000.

Observation End(string)

The end of the observation period. YYYY-MM-DD formatted string, optional, default: 9999-12-31 (latest available)

Observation Start(string)

The start of the observation period. YYYY-MM-DD formatted string, optional, default: 1776-07-04 (earliest available)

Offset(integer)

non-negative integer, optional, default: 0 Minimum: 0.

Output Type(integer)

An integer that indicates an output type. integer, optional, default: 1 One of the following values: '1', '2', '3', '4' 1 = Observations by Real-Time Period 2 = Observations by Vintage Date, All Observations 3 = Observations by Vintage Date, New and Revised Observations Only 4 = Observations, Initia Allowed values: 1, 2, 3, 4.

Realtime End(string)

The end of the real-time period. For more information, see Real-Time Periods , vintage_dates . YYYY-MM-DD formatted string, optional, default: today's date

Realtime Start(string)

The start of the real-time period. For more information, see Real-Time Periods , vintage_dates . YYYY-MM-DD formatted string, optional, default: today's date

Series Id(string)

The id for a series. string, required

Sort Order(string)

Sort results is ascending or descending observation_date order. One of the following strings: 'asc', 'desc'. optional, default: asc Allowed values: asc, desc.

Units(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.

Vintage Dates(string)

A comma separated string of YYYY-MM-DD formatted dates in history (e.g. 2000-01-01,2005-02-24). Vintage dates are used to download data as it existed on these specified dates in history. Vintage dates can be specified instead of a real-time period using realtime_start and realtime_end. Sometimes it

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

series_id: string · required
aggregation_method: string (avg, sum, eop) · optional
file_type: string (json) · optional
frequency: string (d, w, bw, m, q, sa, a, wef, weth, wew, wetu, wem, wesu, wesa, bwew, bwem) · optional
limit: integer · optional
observation_end: string · optional
observation_start: string · optional
offset: integer · optional
output_type: integer (1, 2, 3, 4) · optional
realtime_end: string · optional
realtime_start: string · optional
sort_order: string (asc, desc) · optional
More: +2 optional parameters

Access

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

API README

FRED Get Series Observations API

Get Series Observations 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/series-observations", "series_id": "<series_id>"}'

Parameters

Name	Type	Required	Description
`aggregation_method`	string	No	A key that indicates the aggregation method used for frequency aggregation. This parameter has no affect if the frequency parameter is not set. string, optional
`file_type`	string	No	Response format. Only json is supported.
`frequency`	string	No	An optional parameter that indicates a lower frequency to aggregate values to. The FRED frequency aggregation feature converts higher frequency data series into
`limit`	integer	No	The maximum number of results to return. integer between 1 and 100000, optional, default: 100000
`observation_end`	string	No	The end of the observation period. YYYY-MM-DD formatted string, optional, default: 9999-12-31 (latest available)
`observation_start`	string	No	The start of the observation period. YYYY-MM-DD formatted string, optional, default: 1776-07-04 (earliest available)
`offset`	integer	No	non-negative integer, optional, default: 0
`output_type`	integer	No	An integer that indicates an output type. integer, optional, default: 1 One of the following values: '1', '2', '3', '4' 1 = Observations by Real-Time Period 2 =
`realtime_end`	string	No	The end of the real-time period. For more information, see Real-Time Periods , vintage_dates . YYYY-MM-DD formatted string, optional, default: today's date
`realtime_start`	string	No	The start of the real-time period. For more information, see Real-Time Periods , vintage_dates . YYYY-MM-DD formatted string, optional, default: today's date
`series_id`	string	Yes	The id for a series. string, required
`sort_order`	string	No	Sort results is ascending or descending observation_date order. One of the following strings: 'asc', 'desc'. optional, default: asc
`units`	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
`vintage_dates`	string	No	A comma separated string of YYYY-MM-DD formatted dates in history (e.g. 2000-01-01,2005-02-24). Vintage dates are used to download data as it existed on these s

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/series-observations

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/series-observations" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "limit": 100000,
  "units": "lin",
  "offset": 0,
  "file_type": "json",
  "sort_order": "asc",
  "output_type": 1,
  "observation_end": "9999-12-31",
  "observation_start": "1776-07-04",
  "aggregation_method": "avg"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
FRED Get Series ObservationsThis 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 Get Series Observations API?

Send a POST request to https://api.sandbase.ai/v1/api/fred/series-observations 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 Get Series Observations 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 Get Series Observations API accept?

Required: series_id (string). Optional: aggregation_method (one of avg, sum, eop), file_type (one of json), frequency (one of d, w, bw, m, q, sa, a, wef, weth, wew, wetu, wem, wesu, wesa, bwew, bwem), limit (integer), observation_end (string) and observation_start (string) and 7 more. The Parameters table and the Playground on this page list every field.

What does the FRED Get Series Observations API return?

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

Do I need a FRED developer account or API key?

No. FRED Get Series Observations 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.