{"uid":"cap_nlenWCyLw4jCEYgkiVdC4","slug":"uk-working-days-bank-holidays-api-ec5b3808","name":"UK Working Days & Bank Holidays API","description":"UK public data for AI agents, one origin, pay per call: a one-call postcode report, street crime, live flood warnings, property sales and the House Price Index, food hygiene ratings, MP lookup, NHS GPs, pharmacies and dentists, Companies House checks and search, UK working days and bank holidays, and the cheapest card machine provider. Official sources, attribution in every answer, free preview in every 402, failed requests never charged.","url":"https://uk-data.agent-fee-check.workers.dev/working-days/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":["from","to"],"properties":{"to":{"type":"string","description":"Last day, inclusive, YYYY-MM-DD"},"from":{"type":"string","description":"First day, YYYY-MM-DD"},"region":{"enum":["england-and-wales","scotland","northern-ireland"],"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":{"to":"2026-12-31","from":"2026-01-01","region":"england-and-wales","summary":"8 bank holidays in England and Wales from 2026-01-01 to 2026-12-31.","bank_holidays":[{"day":"Thursday","date":"2026-01-01","title":"New Year’s Day"},{"day":"Friday","date":"2026-04-03","title":"Good Friday"}]}},"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_-Mh6OdbzKCUGTkS9KBc-p","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 a list of UK bank holidays and the count of working days between two dates for a specified UK region","exampleAgentPrompt":"How many bank holidays are there in England and Wales between 2026-01-01 and 2026-12-31, and can you list them all with their dates?","exampleUseCases":[{"title":"Project deadline scheduling in UK","prompt":"I need to know how many working days there are in England and Wales between 2026-03-01 and 2026-06-30 so I can set realistic project milestones — can you list the bank holidays in that period too?"},{"title":"Scottish payroll calendar planning","prompt":"What are all the bank holidays in Scotland from 2026-01-01 to 2026-12-31? I need to plan payroll processing dates around them."},{"title":"Northern Ireland SLA compliance check","prompt":"Can you tell me how many bank holidays fall between 2026-04-01 and 2026-04-30 in Northern Ireland? I need to check whether our 10-business-day SLA is being met."}],"resultDescription":"A JSON object containing the region, the from/to date range, a human-readable summary sentence with the count of bank holidays, and an array of bank holiday objects each with a date (YYYY-MM-DD), day of week, and official title.","failureModes":["Missing required 'from' or 'to' query parameters returns an error","Dates in wrong format (not YYYY-MM-DD) cause a parse error","Invalid region value (not one of england-and-wales, scotland, northern-ireland) returns a validation error","Date range where 'to' is before 'from' may return empty or error response","Payment failure via x402 results in a 402 response with a free preview sample but no full data charged"],"whenToPreferThis":"Choose this endpoint when you need authoritative UK bank holiday data sourced directly from GOV.UK for a specific date range and UK jurisdiction, especially when building scheduling, payroll, SLA, or project planning features that require official attribution. Prefer over generic calendar APIs when UK-specific regional distinctions (England and Wales vs Scotland vs Northern Ireland) matter, and when you need pay-per-call pricing without a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:36:01.251Z","isFirstParty":false,"canonicalSlug":"uk-working-days-bank-holidays-api-ec5b3808"}