---
title: "Get FRED series detail"
method: GET
path: "/api/v2/macro/series/{series_id}"
tags: ["Macro Finance"]
---

# Get FRED series detail

`GET /api/v2/macro/series/{series_id}`

Series catalog detail plus the most recent 24 observations (latest vintage). An unknown or quarantined series_id returns 404 with a message pointing to GET /api/v2/macro/series and the catalog. Requires a plan with Macro & economic data access (`can_use_macro`) — the Corporate & Supply Chain and Global Intelligence plans.

## Path parameters

- `series_id` string, required

## Response `200`

Series detail and recent observations. `series` carries series_id, title, frequency, frequency_short, units, units_short, seasonal_adjustment, observation_start, observation_end, last_updated, source_agency, release_id, release_name, geo_country_iso3, compliance_status, popularity, attribution_text, notes. `recent_observations` is up to 24 { date, value } points (most recent first). Includes the FRED non-endorsement meta.

- object
  - `success` boolean
  - `series` object
    - `series_id` string
    - `title` string
    - `frequency` string
    - `frequency_short` string
    - `units` string
    - `units_short` string
    - `seasonal_adjustment` string
    - `observation_start` string
    - `observation_end` string
    - `last_updated` string
    - `source_agency` string
    - `release_id` integer
    - `release_name` string
    - `geo_country_iso3` string
    - `compliance_status` string
    - `popularity` integer
    - `attribution_text` string
    - `notes` string
  - `recent_observations` object[]
    - `date` string
    - `value` number
  - `meta` object
    - `attribution` string
    - `source` string

## Other responses

- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED) — the caller's plan does not carry the required source entitlement.
- `404` — Series not found or not available (NOT_FOUND)
- `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)