Properties
| Name | Type | Description |
|---|---|---|
| name | string | Name of the bank holiday. |
| date | string | Date of the bank holiday in YYYY-MM-DD format. |
| country | string | 2-letter ISO 3166-1 alpha-2 country code. |
| year | integer | Calendar year of `date`. |
| regions | array | ISO 3166-2 codes of the states, provinces or regions where the holiday applies (e.g. `GB-SCT`). |
| actual_date | string | Calendar date of the holiday itself. Differs from `date` only on observed days. |
| observed | boolean | True when `date` is an observed or substitute day off for a holiday that falls on another day. |
| holiday_id | string | Stable identifier of the holiday, the same every year (e.g. `US.independence_day`). An observed day shares the id of its holiday. |
| status | string | `tentative` for dates that depend on a lunar sighting or have not yet been officially announced; they may move by a day. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-bank-holiday-schema.json",
"title": "BankHoliday",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/api-ninjas-com-bank-holidays-api-openapi.yml#/components/schemas/BankHoliday",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the bank holiday."
},
"date": {
"type": "string",
"format": "date",
"description": "Date of the bank holiday in YYYY-MM-DD format."
},
"country": {
"type": "string",
"description": "2-letter ISO 3166-1 alpha-2 country code."
},
"year": {
"type": "integer",
"description": "Calendar year of `date`."
},
"regions": {
"type": "array",
"items": {
"type": "string"
},
"description": "ISO 3166-2 codes of the states, provinces or regions where the holiday applies (e.g. `GB-SCT`)."
},
"actual_date": {
"type": "string",
"format": "date",
"description": "Calendar date of the holiday itself. Differs from `date` only on observed days."
},
"observed": {
"type": "boolean",
"description": "True when `date` is an observed or substitute day off for a holiday that falls on another day."
},
"holiday_id": {
"type": "string",
"description": "Stable identifier of the holiday, the same every year (e.g. `US.independence_day`). An observed day shares the id of its holiday."
},
"status": {
"type": "string",
"enum": [
"confirmed",
"tentative"
],
"description": "`tentative` for dates that depend on a lunar sighting or have not yet been officially announced; they may move by a day."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/api-ninjas-com-bank-holiday"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.