Discovery
Alerts

FREE re-verification calendar — derived window plus an optional recorded effective_to end

Free. Forward-looking companion to /v1/changes from stored fields only: reverify_by (our re-check cadence, not a government date) and next_effective_known when the served value has an end date; otherwise "unknown". A 402 here is a bug: do not pay.

get/v1/calendar

Request

  • Base URL: https://afriref.dev
  • URL: https://afriref.dev/v1/calendar
  • Auth: none required

Query parameters

countrystring

Optional ISO 3166-1 alpha-2, case-insensitive. Must be in this brand's continent catalog. Not two letters → HTTP 400, free. Not in this brand → HTTP 404, free.

seriesstring

Optional series id (for example policy-rate). A valid country (or no country) with no match returns HTTP 200 and an empty entries list. A malformed series query is HTTP 400, free.

Response

Free and unmetered. price_note says so. Entries may mix status known and status unknown. Known copies current.effective_to into next_effective_known. Unknown omits next_effective_known and next_effective_basis. No payment headers.

as_ofstring date required
brandstring required
countinteger required
notestring required

States that reverify_by is derived, that next_effective_known comes only from current.effective_to, and that notes prose is never parsed.

price_notestring required

States that this feed is free and unmetered, and points at GET /v1/changes for past moves. Series values remain paid at GET /v1/{country}/{series}.

disclaimerstring required

Changes

No recorded changes to this operation across all 3 revisions of this API.