Skip to main content
POST
/
api
/
fred
/
series
/
observations
/fred/series/observations
curl --request POST \
  --url https://api.anysite.io/api/fred/series/observations \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "series_id": "<string>",
  "count": 2,
  "timeout": 300,
  "observation_start_date": "2010-01-01",
  "observation_end_date": "2023-12-31",
  "aggregation_method": "avg",
  "units": "lin"
}
'
[
  {
    "date": "<string>",
    "@type": "@fred_observation",
    "value": 123
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
series_id
string
required

Series identifier

Examples:

"GNPCA"

"UNRATE"

"GDP"

count
integer
required

Number of observations to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
observation_start_date
string | null

Earliest observation date to include, inclusive

Example:

"2010-01-01"

observation_end_date
string | null

Latest observation date to include, inclusive

Example:

"2023-12-31"

frequency
enum<string> | null

Resample the series to this frequency

Available options:
Daily,
Weekly, Ending Friday,
Weekly, Ending Thursday,
Weekly, Ending Wednesday,
Weekly, Ending Tuesday,
Weekly, Ending Monday,
Weekly, Ending Sunday,
Weekly, Ending Saturday,
Biweekly, Ending Wednesday,
Biweekly, Ending Monday,
Monthly,
Quarterly,
Semiannual,
Annual
aggregation_method
enum<string>
default:avg

How values are aggregated when resampling to a lower frequency

Available options:
avg,
sum,
eop
units
enum<string>
default:lin

Value transformation applied to the observations

Available options:
lin,
chg,
ch1,
pch,
pc1,
pca,
cch,
cca,
log

Response

Successful Response

date
string
required
@type
string
default:@fred_observation
value
number | null