← Back to schema index

`SpeiCalendarResponse`

Response from `GET /v1/public/spei-calendar/{year}`. A single resource with the SPEI non-business days of the year and its source, and in `meta.covered_years` the years that have a calendar. A year without a calendar responds `404`, not this body.

Properties

Field	Type	Description
`data`	`object`	Main response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
`type`*	`string`	JSON:API resource type. Always `spei_calendar`.
`id`*	`string`	Calendar year (four digits).
`attributes`*	`object`	Data of the year's calendar.
`year`*	`integer`	Calendar year (four digits). Same value as `id`.
`non_business_days`*	`array`	Non-business days that fall from Monday to Friday (`YYYY-MM-DD`), from lowest to highest. Saturdays and Sundays are also non-business days and are not repeated here.
`source`*	`object`	Official provision the calendar comes from.
`issuer`*	`string`	Acronym of the authority that issues the provision, for example `CNBV`.
`published_in`*	`string`	Acronym of the official gazette that published the provision, for example `DOF`.
`published_on`*	`string (date)`	Publication date of the provision (`YYYY-MM-DD`).
`title`*	`string`	Official title of the provision, in Spanish.
`meta`	`object`	Response metadata including API version, route prefix, unique request identifier, and the server timestamp in UTC.
`version`	`string`	API version that processed the request.
`api_version`	`string`	API route prefix version (e.g. `v1`).
`request_id`	`string`	Unique request identifier (hex).
`datetime`	`object`	Companion descriptor present in the `meta` block of every response (and in the `meta` of outgoing webhook bodies). Lets clients assert the timezone contract without re-reading the spec.
`timezone`*	`string`	Always `UTC`: The canonical timezone for every datetime field in the body.
`format`*	`string`	Always `ISO 8601`: Explicit `Z` suffix on every datetime.
`links`	`object`	Pagination or related links, present only when the endpoint returns a paginated collection.

Used in operations

GET /v1/public/spei-calendar/{year}