{"uid":"cap_0qrHwNhunilMtkoTSFXlG","slug":"business-day-deadline-api-e97f66ab","name":"Business Day & Deadline API","description":"Verified, always-current business-day arithmetic for ~200 countries incl. subdivisions (German Bundeslaender, US states) and correct per-country weekend rules (e.g. Fri/Sat in Egypt). Informational only — verify legally binding deadlines with the competent authority. Not legal advice.","url":"https://businessdayapi.com/v1/check?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":["date","country"],"properties":{"date":{"type":"string","description":"ISO date YYYY-MM-DD"},"region":{"type":"string","description":"optional ISO 3166-2 subdivision suffix, e.g. BY (Bavaria), CA (California)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. DE, US, JP"},"weekend":{"type":"string","description":"optional override: sat-sun | fri-sat | custom:THU,FRI"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"date":"2026-10-03","reason":"weekend","region":"BY","source":"nager.date","country":"DE","verifiedAt":"2026-08-17T00:00:00Z","holidayName":"Tag der Deutschen Einheit","isBusinessDay":false}},"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":"unknown","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_bIQTXxP3_InqsZ1ttY1p1","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":"Checks whether a given date is a business day for a specific country (and optional subdivision), accounting for local holidays and country-specific weekend rules.","exampleAgentPrompt":"Is October 3rd 2026 a business day in Germany — specifically Bavaria? I need to know if it's a holiday or weekend before I schedule a payment deadline.","exampleUseCases":[{"title":"Legal deadline verification for contracts","prompt":"Can you check if December 26th 2026 is a business day in the UK? I need to confirm whether a contract signing deadline that falls on that date is actually a working day or not."},{"title":"Invoice scheduling across international offices","prompt":"Is March 20th 2026 a working day in Egypt? I know they use a Friday-Saturday weekend there, so I want to make sure before I schedule an invoice due date."},{"title":"US state-specific payroll cutoff check","prompt":"Is November 11th 2026 a business day in California? I want to verify if Veterans Day is observed as a public holiday there before we set the payroll processing cutoff."}],"resultDescription":"A JSON object confirming whether the queried date is a business day, including the country, optional region, the reason if it is not (e.g. 'weekend' or named holiday), the holiday name if applicable, the data source (e.g. nager.date), and a verifiedAt timestamp indicating when the holiday data was last confirmed.","failureModes":["Missing required 'date' or 'country' parameters returns a 400 error","Invalid ISO date format returns a parsing error","Unsupported or unrecognized country code may return no data or an error","Invalid region/subdivision code may be ignored or return an error","Weekend override with an unrecognized custom format may fail silently or return an error","Network timeout or upstream data source unavailability may cause delayed or failed responses"],"whenToPreferThis":"Choose this endpoint when you need authoritative, always-current business-day determination for a wide range of countries including those with non-standard weekends (e.g. Fri/Sat in Egypt, Thu/Fri in some Middle Eastern countries) or subnational holiday rules (e.g. German Bundesländer, US states). It is especially useful for scheduling systems, invoice/payment deadline automation, and contract date validation. Prefer it over general-purpose date libraries which may have stale or incomplete holiday data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:37:46.346Z","isFirstParty":false,"canonicalSlug":"business-day-deadline-api-e97f66ab"}