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

{
  "$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"
  ]
}