---
title: "Historical observations for a FRED series, newest first, with the series metadata embedded."
method: GET
path: "/v1/fred/series/{seriesId}/observations"
tags: ["Fred"]
---

# Historical observations for a FRED series, newest first, with the series metadata embedded.

`GET /v1/fred/series/{seriesId}/observations`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/fred/series/{seriesId}/observations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/fred/series/:seriesId/observations/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `seriesId` string, required

## Query parameters

- `startDate` string, date
- `endDate` string, date
- `limit` integer
- `offset` integer

## Response `200`

OK

- FredObservationsResponse
  - `series` FredSeriesHeaderDto
    - `id` string, nullable
    - `title` string, nullable
    - `units` string, nullable
    - `frequency` string, nullable
    - `countryCode` string, nullable: The economy the series measures, as an ISO country code: US or CA.
    - `source` string, nullable: The publisher the series is read from: Fred, BankOfCanada or StatisticsCanada.
    - `seasonalAdjustment` string, nullable: Seasonal-adjustment basis as published by FRED (e.g. "Seasonally Adjusted", "Not Seasonally Adjusted"); null when FRED lists none.
    - `lastUpdated` string, date-time, nullable: When Equibles last synced the series (UTC); this is pipeline freshness, not the latest observation's economic period. Null when unknown.
  - `data` FredObservationDto[], nullable
    - `date` string, date
    - `value` number, double, nullable
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-11-06** `666e06778588`: 5 info
  - added the optional property `error/availableDates` to the response with the `400` status
  - added the optional property `error/availableDates` to the response with the `404` status
  - added the optional property `meta/total` to the response with the `200` status
  - added the optional property `series/countryCode` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/equibles/apis/equibles-api/changes/v1/fred/series/:seriesId/observations/get.md)

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/83f13ba1a993?raw)