EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

economics

Indicator history

https://docs.economicsapi.com/endpoints/gethistory
gethttps://api.economicsapi.com/v1/history

Use the same country and indicator as /v1/latest, with optional from/to years or dates. Example: country=mexico&indicator=inflation&from=2020. Follow next_cursor until null for the complete result.

curl -X GET "https://api.economicsapi.com/v1/history?country=mexico&indicator=inflation" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx"

Authorization

Authorizationstringheaderrequired

Bearer token. API key from your economicsapi dashboard Format: `Bearer sk_live_xxxxxxxxxxxxxxxxxxxx`.

Query parameters

countrystring | null

Country name, ISO2/ISO3, slug or group; comma-listable

Example: "mexico"

indicatorstring | null

Common name (inflation, unemployment), slug, or KPI ID; comma-listable

Example: "inflation"

fromstring | null

YYYY or YYYY-MM-DD

tostring | null

YYYY or YYYY-MM-DD

transformstringdefault "none"

none | yoy | mom | log_diff | 3mma

cursorstring | null

next_cursor from the previous page

Response

200Successful Responseapplication/json
dataObservationOut[]required
next_cursorstring | null
retrieved_atstring<date-time>required
reproduction_urlstringrequired
401Missing or invalid API keyapplication/json
errorstring
messagestring
request_idstring
422Validation Errorapplication/json
detailValidationError[]
429Rate limit exceededapplication/json
errorstring
messagestring
request_idstring
Response
{
  "data": [
    {
      "series_id": "id_a1b2c3d4",
      "country_id": "id_a1b2c3d4",
      "kpi_id": "id_a1b2c3d4",
      "date": "2026-01-01",
      "value": 0,
      "frequency": "example",
      "obs_status": "A",
      "observation_status": "active",
      "unit": "example",
      "unit_code": "example",
      "value_type": "standard",
      "comparison_basis": "example",
      "price_basis": "example",
      "interpretation": "example",
      "adjustment": "example",
      "source_id": "id_a1b2c3d4",
      "source_series_id": "id_a1b2c3d4",
      "source_name": "Acme Corp",
      "source_url": "https://example.com/callback",
      "license_id": "id_a1b2c3d4",
      "attribution_text": "example",
      "coverage_start": "2026-01-01",
      "coverage_end": "2026-01-01",
      "coverage_observation_count": 0,
      "is_derived": false,
      "transformation": "none",
      "transformation_formula": "example",
      "last_update": "2026-01-01T00:00:00Z"
    }
  ],
  "next_cursor": "example",
  "retrieved_at": "2026-01-01T00:00:00Z",
  "reproduction_url": "https://example.com/callback"
}