FRED · JSON Structure

Api Observation Structure

A single time-series observation.

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

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

Properties

realtime_start realtime_end date value

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-observation-structure.json",
  "name": "Observation",
  "description": "A single time-series observation.",
  "type": "object",
  "properties": {
    "realtime_start": {
      "type": "date",
      "example": "2026-05-28"
    },
    "realtime_end": {
      "type": "date",
      "example": "2026-05-28"
    },
    "date": {
      "type": "date",
      "description": "Observation date.",
      "example": "2026-05-28"
    },
    "value": {
      "type": "string",
      "description": "Observation value (string to preserve \".\" for missing values).",
      "example": "4.0"
    }
  },
  "required": [
    "date",
    "value"
  ]
}