{"uid":"cap_6hcN4NXGrb0grBi-IzJcN","slug":"uk-working-days-count-d345a0e3","name":"UK Working Days Count","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/count?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-12-01","region":"england-and-wales","summary":"21 working days from 2026-12-01 to 2026-12-31 inclusive in England and Wales (2 weekday bank holidays).","weekend_days":8,"working_days":21,"bank_holidays":[{"date":"2026-12-25","title":"Christmas Day"},{"date":"2026-12-28","title":"Boxing Day"}],"calendar_days":31}},"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_FrMRXEuRk9gk8IBtpHU2a","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":"Counts UK working days between two dates for a specified UK region, listing bank holidays that fall on weekdays within the range.","exampleAgentPrompt":"How many working days are there from December 1st to December 31st 2026 in England and Wales, and which bank holidays fall on weekdays in that period?","exampleUseCases":[{"title":"Invoice payment deadline planning","prompt":"How many working days are there between January 5th and February 5th 2027 in England and Wales? I need to work out when a 20-working-day invoice payment term expires."},{"title":"Project timeline calculation for Scotland","prompt":"We're planning a project in Scotland — can you tell me how many working days there are from March 1st to March 31st 2027, and list any Scottish bank holidays in that window?"},{"title":"End-of-year payroll working days","prompt":"How many working days are there in December 2026 in Northern Ireland? I need this for payroll calculations and want to know which bank holidays fall on weekdays."}],"resultDescription":"Returns a JSON object with: total working days count, total calendar days, weekend day count, the from/to dates, the UK region, a human-readable summary string, and an array of bank holiday objects (each with date and title) that fall on weekdays within the specified range.","failureModes":["Missing required 'from' or 'to' query parameters returns a 400 error","Invalid date format (not YYYY-MM-DD) causes a parsing error","Invalid region value (not one of the three allowed enums) returns an error","Date range where 'to' is before 'from' may return zero or error","Payment not completed results in 402 with a free preview response"],"whenToPreferThis":"Use this endpoint when you need an authoritative, official UK working-day count that correctly handles bank holidays per region (England & Wales, Scotland, Northern Ireland). Prefer it over generic date-math libraries that don't know UK bank holidays, or when you need region-specific results (e.g. Scotland has different bank holidays). Ideal for payroll, invoicing, project planning, SLA calculations, and any deadline computation that must account for UK public holidays.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:39:34.381Z","isFirstParty":false,"canonicalSlug":"uk-working-days-count-d345a0e3"}