Get Observations

Retrieve time-series observations with optional transformations and vintage selection.

GET /api/indicators/{slug}/observations

Returns the observation array for a curated indicator.

Endpoint

GET /api/indicators/{slug}/observations

Query Parameters

NameTypeDescription
countryISO country codeResolves a country-specific indicator slug when a country variant exists.

Response

{
  "observations": [
    { "date": "2025-12-31", "value": 2.4, "revised": true }
  ]
}

Caching

This route uses the public route cache headers shared by indicator read APIs. For real-time operational checks, use provider health and sync status endpoints instead of treating this as a sync freshness endpoint.

Vintage Scope

This endpoint returns the current observation series. Historical vintage reads are exposed through the revisions endpoint where a provider supports real vintage or revision data.