FRED · Schema

Series

A FRED economic data series and its metadata.

FinanceGovernmentEconomic DataFederal ReserveTime SeriesOpen DataPublic APIs

Properties

Name Type Description
id string FRED series ID (e.g. UNRATE
realtime_start string
realtime_end string
title string Display title of the series.
observation_start string First available observation date.
observation_end string Last available observation date.
frequency string Display frequency (e.g. "Monthly").
frequency_short string Frequency code (d
units string Display unit string.
units_short string Short unit string.
seasonal_adjustment string Seasonal adjustment description.
seasonal_adjustment_short string Seasonal adjustment code (SA
last_updated string ISO-8601 timestamp of last update.
popularity integer Popularity score 0–100.
group_popularity integer Group popularity score 0–100.
notes string Editorial notes for the series.
View JSON Schema on GitHub

JSON Schema

api-series-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/fred/refs/heads/main/json-schema/api-series-schema.json",
  "title": "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": "string",
      "format": "date",
      "example": "2026-05-28"
    },
    "realtime_end": {
      "type": "string",
      "format": "date",
      "example": "2026-05-28"
    },
    "title": {
      "type": "string",
      "description": "Display title of the series.",
      "example": "Unemployment Rate"
    },
    "observation_start": {
      "type": "string",
      "format": "date",
      "description": "First available observation date.",
      "example": "2026-05-28"
    },
    "observation_end": {
      "type": "string",
      "format": "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": "integer",
      "description": "Popularity score 0\u2013100.",
      "example": 95
    },
    "group_popularity": {
      "type": "integer",
      "description": "Group popularity score 0\u2013100.",
      "example": 95
    },
    "notes": {
      "type": "string",
      "description": "Editorial notes for the series.",
      "example": "Editorial notes."
    }
  },
  "required": [
    "id",
    "title"
  ]
}