get_calendar
Read-onlyIdempotent
FREE, unmetered. GET /v1/calendar for this brand's continent. Optional country (ISO 3166-1 alpha-2) and series. Derives reverify_by from last_confirmed + update_cycle_days (the same window that sets stale) and, only when current.effective_to is a non-empty string, next_effective_known with basis effective_to. status unknown omits that date. Never parses notes. Does not invent MPC, budget, or wage-review dates. next_effective_known is the recorded end of the current value, not a promised gazette event. A 402 is a gate bug — do not pay. Past changes stay on get_changes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| series | No | Optional series id (for example policy-rate). Omit for every series. A valid country with no match stays free. | |
| country | No | Optional ISO 3166-1 alpha-2. Omit for every series on this brand's continent. Unknown to the catalog is 404 free. Not two letters is 400 free. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | ||
| brand | No | ||
| count | No | ||
| error | No | Present on a free refusal or error; no charge | |
| entries | No | ||
| no_charge | No | ||
| price_usd | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| bind_series | No | ||
| explanation | No | ||
| x_next_bind | No | ||
| http_endpoint | No | ||
| payment_required | No | true when the call needs payment; how_to_pay explains x402 or card |