EconomicsAPI
Get API key
Get startedIntegrateAPI ReferenceChangelog

economics

Indicator forecasts

https://docs.economicsapi.com/endpoints/getforecast
gethttps://api.economicsapi.com/v1/forecast

Predicted indicator values by date. Use country=mexico&indicator=inflation. Lower and upper show the 80% prediction interval. An empty result means no published forecast is available.

curl -X GET "https://api.economicsapi.com/v1/forecast?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"

groupstring | null

indicator group, e.g. prices

horizoninteger | null

only steps up to this many periods ahead

min 1 · max 12

Response

200Successful Responseapplication/json
dataForecastCard[]required
401Missing or invalid API keyapplication/json
errorstring
messagestring
request_idstring
422Validation Errorapplication/json
detailValidationError[]
429Rate limit exceededapplication/json
errorstring
messagestring
request_idstring
Response
{
  "data": [
    {
      "country_id": "id_a1b2c3d4",
      "country": "United States",
      "indicator": "example",
      "slug": "example",
      "frequency": "example",
      "unit": "example",
      "forecast": [
        {
          "date": "2026-01-01",
          "value": 0,
          "lower": 0,
          "upper": 0
        }
      ]
    }
  ]
}