{"uid":"cap_8-epBgxMr9KJSqxd6HhDV","slug":"uk-government-bank-holidays-api-3614e44f","name":"UK Government Bank Holidays API","description":"UK public (bank) holidays from GOV.UK for England and Wales, Scotland or Northern Ireland, optionally for one year. Official list published by GOV.UK; dates only, no working-day calculation.","url":"https://api.chainmarket-api.workers.dev/api/finance/gov-uk-bank-holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"year":{"type":"string","description":"Optional 4-digit year, e.g. 2026"},"division":{"type":"string","description":"england-and-wales (default), scotland or northern-ireland"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":"2026","count":8,"source":"https://www.gov.uk/bank-holidays.json","division":"england-and-wales","holidays":[{"date":"2026-01-01","notes":"","title":"New Year’s Day","bunting":true},{"date":"2026-04-03","notes":"","title":"Good Friday","bunting":false}],"checkedAt":"2026-10-23T09:36:17.455Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XFiaTJ3oLHuiglSRZSzqp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official UK bank holidays for a specified division and year, sourced from the GOV.UK bank-holidays.json feed.","exampleAgentPrompt":"Can you pull up the official UK bank holidays for England and Wales in 2026 so I can plan around them?","exampleUseCases":[{"title":"Payroll scheduling around UK holidays","prompt":"I need to know all the bank holidays in England and Wales for 2025 so I can adjust our payroll run dates — can you fetch the official list from GOV.UK?"},{"title":"Scottish holiday calendar for project planning","prompt":"What are the official bank holidays in Scotland for 2026? I'm planning a project timeline and need to know which dates to avoid."},{"title":"Checking Northern Ireland holiday compliance","prompt":"Can you get me the complete list of bank holidays in Northern Ireland for this year so I can check our trading hours policy is compliant?"}],"resultDescription":"Returns a JSON object containing the division queried, the year, a count of holidays, a list of bank holiday objects (each with date, title, notes, and bunting flag), the source URL (gov.uk), and a checkedAt timestamp indicating when the data was retrieved.","failureModes":["Invalid division string returns an error or defaults to england-and-wales","Invalid or out-of-range year may return empty results or an error","Payment failure over x402 protocol results in no charge and no response","GOV.UK source unavailable may cause stale or failed data retrieval"],"whenToPreferThis":"Choose this endpoint when you need authoritative, up-to-date UK bank holiday data without managing an API key or signup, especially in agentic workflows that require pay-per-call microtransactions via x402. Prefer it over scraping gov.uk directly or maintaining a static holiday list, as it wraps the official GOV.UK JSON feed with structured output and division filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:38:21.229Z","isFirstParty":false,"canonicalSlug":"uk-government-bank-holidays-api-3614e44f"}