---
title: "List FRED observations"
method: GET
path: "/api/v2/macro/observations"
tags: ["Macro Finance"]
---

# List FRED observations

`GET /api/v2/macro/observations`

Point-in-time observations for a single series. Optional `as_of` selects the vintage known on/before that date (ALFRED — no look-ahead); otherwise the latest vintage is returned. When no dates are given, returns the most-recent observations across the full available history, bounded by `limit` — page further back via `next_cursor`; there is no fixed trailing window. Discover a valid series_id via GET /api/v2/macro/series or the catalog: https://docs.gdeltcloud.com/api-reference/macro-series-catalog. Requires a plan with Macro & economic data access (`can_use_macro`) — the Corporate & Supply Chain and Global Intelligence plans.

## Query parameters

- `series_id` string, required
- `date_start` string
- `date_end` string
- `as_of` string
- `limit` integer
- `cursor` string

## Response `200`

A page of observations for the series, most recent first. Each row: date, value, vintage (the realtime_start the value became known). Echoes series_id and includes the FRED non-endorsement meta.

- object
  - `success` boolean
  - `series_id` string
  - `data` object[]
    - `date` string
    - `value` number
    - `vintage` string
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` string
  - `applied_filters` object
    - `series_id` string
    - `date_start` string
    - `as_of` string
    - `ignored` object
  - `meta` object
    - `attribution` string
    - `source` string

## Other responses

- `400` — series_id is required (MISSING_PARAM)
- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED) — the caller's plan does not carry the required source entitlement.
- `500` — Server error

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/versions/01aaa6255180/schema)