FRED · JSON Structure

Api Series Structure

A FRED economic data series and its metadata.

Type: object Properties: 16 Required: 2
FinanceGovernmentEconomic DataFederal ReserveTime SeriesOpen DataPublic APIs

Series is a JSON Structure definition published by FRED, describing 16 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id realtime_start realtime_end title observation_start observation_end frequency frequency_short units units_short seasonal_adjustment seasonal_adjustment_short last_updated popularity group_popularity notes

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/fred/refs/heads/main/json-structure/api-series-structure.json",
  "name": "Series",
  "description": "A FRED economic data series and its metadata.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "FRED series ID (e.g. UNRATE",
      "GNPCA).": null,
      "example": "UNRATE"
    },
    "realtime_start": {
      "type": "date",
      "example": "2026-05-28"
    },
    "realtime_end": {
      "type": "date",
      "example": "2026-05-28"
    },
    "title": {
      "type": "string",
      "description": "Display title of the series.",
      "example": "Unemployment Rate"
    },
    "observation_start": {
      "type": "date",
      "description": "First available observation date.",
      "example": "2026-05-28"
    },
    "observation_end": {
      "type": "date",
      "description": "Last available observation date.",
      "example": "2026-05-28"
    },
    "frequency": {
      "type": "string",
      "description": "Display frequency (e.g. \"Monthly\").",
      "example": "Monthly"
    },
    "frequency_short": {
      "type": "string",
      "description": "Frequency code (d",
      "w": null,
      "m": null,
      "q": null,
      "a).": null,
      "example": "Monthly"
    },
    "units": {
      "type": "string",
      "description": "Display unit string.",
      "example": "Percent"
    },
    "units_short": {
      "type": "string",
      "description": "Short unit string.",
      "example": "Percent"
    },
    "seasonal_adjustment": {
      "type": "string",
      "description": "Seasonal adjustment description.",
      "example": "Seasonally Adjusted"
    },
    "seasonal_adjustment_short": {
      "type": "string",
      "description": "Seasonal adjustment code (SA",
      "NSA": null,
      "SAAR": null,
      "NSAAR": null,
      "SSA).": null,
      "example": "SA"
    },
    "last_updated": {
      "type": "string",
      "description": "ISO-8601 timestamp of last update.",
      "example": "2026-05-02 07:46:10-05"
    },
    "popularity": {
      "type": "int32",
      "description": "Popularity score 0\u2013100.",
      "example": 95
    },
    "group_popularity": {
      "type": "int32",
      "description": "Group popularity score 0\u2013100.",
      "example": 95
    },
    "notes": {
      "type": "string",
      "description": "Editorial notes for the series.",
      "example": "Editorial notes."
    }
  },
  "required": [
    "id",
    "title"
  ]
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/api-series-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.