---
title: "Release calendar"
method: GET
path: "/api/v1/calendar"
---

# Release calendar

`GET /api/v1/calendar`

## Request

- Base URL: `https://invokely.ai`
- URL: `https://invokely.ai/api/v1/calendar`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`
  - none

When official figures come out: the scheduled releases of the publishers behind Invokely (BLS, BEA, Census, Treasury, Eurostat, ECB, INE, ONS, CSO calendars, read daily), from 30 days back to 90 days ahead.
Use it for "When is the next US CPI release?", "When is the next jobs report?", "What does Eurostat publish this week?" or "What comes out for Spain this month?".
Example: {"indicator": "cpi_annual_change", "country": "US"}. Jobs report: {"indicator": "unemployment_rate", "country": "US"}. One publisher for a week: {"source": "eurostat", "from": "2026-10-12", "to": "2026-10-18"}. Releases for a place: {"place": "Texas"}.
Filters: indicator (id), place (lists releases of the series available for that place), source (source id or publisher name), country (ISO code of the publisher, "EU" for Eurostat and the ECB), from and to (YYYY-MM-DD; default today to 30 days ahead). By default only releases that update an Invokely indicator are listed; include_unlinked adds the publisher's other releases.
Returns {from, to, filters, releases: [{title, publisher, scheduled_at (UTC), date, time_known, local_time?, time_zone, reference_period?, status, origin, confidence?, note?, url?, indicators, state, result?}], total, last_release?, note}.
Results ("what did the jobs report show?", "what came out today?"): pass from in the past. state is scheduled, postponed, released, figures_loading (out or due, figures not stored yet), published (out days ago, figures not in Invokely) or cancelled. A released release with a national headline series has result: {indicator, place, period, value, previous {period, value}, change {text, direction, kind}, as_of, source}. change is in points for rates and in percent for levels. The figure is as Invokely stored it after the release (as_of); call get_revisions for later revisions. Cite result.source.
origin "publisher_calendar" is the publisher's announced date. origin "estimated" is Invokely's estimate from past publication dates for series without a publisher calendar: say it is an estimate and give its confidence, never present it as an announced date. time_known false means only the day is announced. status is scheduled, released, postponed or cancelled.

## Query parameters

- `indicator` string
- `place` string
- `source` string
- `country` string
- `from` string, date
- `to` string, date
- `include_unlinked` boolean
- `limit` integer

## Response `200`

Success. The body is {"data": ...}; the remaining allowance is in the x-invokely-remaining header.

- Data
  - `data` unknown, required

## Other responses

- `400`: Invalid argument (INVALID_ARGUMENT).
- `401`: The API key or token is invalid or revoked (UNAUTHORIZED).
- `402`: Allowance used up (QUOTA_EXHAUSTED), or the plan does not include the REST API (PLAN_REQUIRED: Free keys; use the MCP server or upgrade to Builder).
- `404`: Unknown indicator or place, or no data (INDICATOR_NOT_FOUND, PLACE_NOT_FOUND, AMBIGUOUS_PLACE, NO_DATA). hint and suggestions say what to try next.
- `429`: Rate limited (RATE_LIMITED). Retry after retry_after_seconds.

---

[API](https://skmtc.dev/invokely/apis/invokely-statistics-api.md) · [All operations](https://skmtc.dev/invokely/apis/invokely-statistics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/invokely/apis/invokely-statistics-api/revisions/3b0f775bccb6?raw)