# nextbank.holiday

> When is the next bank holiday (public holiday)? Accurate dates for 41 regions in the UK, Ireland, France, Germany and Spain, in English, French, German and Spanish.

## How to use it

- JSON API (OpenAPI 3.1): https://nextbank.holiday/api/v1/openapi.json
- Next holiday: https://nextbank.holiday/api/v1/{country}/{region}/next  e.g. https://nextbank.holiday/api/v1/gb/scotland/next
- All holidays in a year: https://nextbank.holiday/api/v1/{country}/{region}/holidays?year=2026
- By ISO code: https://nextbank.holiday/api/v1/next?country=GB&region=SCT
- Regions list: https://nextbank.holiday/api/v1/regions
- Calendar feed: https://nextbank.holiday/{country}/{region}.ics
- Add ?lang=en|fr|de|es to choose the language of holiday names.

## Pricing

Web pages are free for everyone, including crawlers.
The JSON API and .ics feeds are free for people and ordinary scripts (rate limited), but clients identified as AI agents or AI crawlers are asked to pay 0.001 USD per request using the x402 protocol (HTTP 402 with payment requirements). This is an experiment to see how agents behave when asked to pay. Details: https://nextbank.holiday/about

## Notes

- Dates are computed in each region's timezone, so "next" is correct on the day.
- Data comes from gov.uk (UK) and the date-holidays library, refreshed weekly.