{"uid":"cap_EJqFuCK6RYotci8kuurAu","slug":"agent402-uk-bank-holidays-fbdaf8ea","name":"Agent402 UK Bank Holidays","description":"Don't burn tokens on deterministic work. Go/no-go jobs first: payout preflight, text firewall (PII/secrets), budget check — then rails, calendars, finmath. x402 USDC on Base. UK + global. agent402.co.uk — not agent402.tools. $0.001–$0.002 USDC on Base. No API keys.","url":"https://agent402.co.uk/v1/uk/bank-holidays","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","properties":{"to":{"type":"string","description":"To YYYY-MM-DD inclusive"},"from":{"type":"string","description":"From YYYY-MM-DD inclusive"},"year":{"type":"string","description":"Calendar year filter"},"region":{"type":"string","description":"Alias for division"},"division":{"type":"string","description":"england-and-wales | scotland | northern-ireland (or all)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":8,"events":[{"date":"2026-01-01","title":"New Year’s Day","division":"england-and-wales"}],"source":"https://www.gov.uk/bank-holidays.json"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z14E0_g0hpqyTmxCeZDVu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official UK public bank holidays for England & Wales, Scotland, and Northern Ireland from GOV.UK, filterable by region and date range.","exampleAgentPrompt":"Can you get me all the bank holidays in England and Wales for 2025 so I can flag them in our payroll calendar?","exampleUseCases":[{"title":"Payroll schedule for UK staff","prompt":"Pull all the bank holidays for England and Wales in 2025 — I need to mark them in our payroll system so we don't process runs on public holidays."},{"title":"CHAPS cut-off planning","prompt":"What are the bank holidays in Scotland between January and March 2025? I need to know so we can adjust our CHAPS payment cut-off dates."},{"title":"SLA calendar exclusions","prompt":"Can you fetch all UK bank holidays for Northern Ireland this year so I can exclude them from our customer SLA working-day calculations?"}],"resultDescription":"A structured JSON list of bank holidays for the requested UK division(s) and date range, sourced from GOV.UK OGL data. Each entry includes the holiday name and date. Results can be filtered by region (england-and-wales, scotland, northern-ireland, or all) and optionally scoped to a specific year or date range.","failureModes":["Invalid division value returns an error — must be one of: england-and-wales, scotland, northern-ireland, or all","Malformed date format for from/to parameters causes a parsing error","Requesting dates far outside the GOV.UK published range may return an empty result set","Network or upstream GOV.UK API unavailability may cause a service error"],"whenToPreferThis":"Use this endpoint when you need authoritative, government-sourced UK bank holiday data for any of the three UK divisions. It is ideal for payroll systems, financial settlement scheduling (e.g. CHAPS), SLA calendars, and any workflow that must exclude UK public holidays. Prefer this over generic calendar APIs when UK-specific legal accuracy and division-level granularity (England & Wales vs Scotland vs Northern Ireland) are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:25:27.111Z","isFirstParty":false}