{"uid":"cap_DGywesVnvM8nXJowvUoH3","slug":"business-days-and-holidays-9ea17d93","name":"Business Days and Holidays","description":"Business days and public holidays: check if a date is a business day, add or subtract N business days, count business days between dates, or list holidays, for 250 countries, 630 subdivisions (e.g. US-NY, GB-ENG) and 31 stock exchanges, 2025-2030. Use for payment due dates, T+N settlement, delivery estimates and SLAs. Data: python-holidays (MIT). Signed receipt.","url":"https://api.stablecoingateways.com/v1/business-days?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"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","properties":{"op":{"enum":["check","add","between","list"],"type":"string","description":"Operation; default check"},"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date for op=between"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD; default today"},"days":{"type":"string","pattern":"^-?\\d{1,4}$","description":"Business days to add (op=add), integer, |days|<=1000"},"year":{"type":"string","pattern":"^20(2[5-9]|30)$","description":"Year for op=list, 2025-2030"},"calendar":{"type":"string","description":"ISO country (US), country-subdivision (US-NY) or exchange (FIN-XNYS); default US"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","receipt"],"properties":{"data":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"op":{"type":"string"},"days":{"type":"integer"},"start":{"type":"string"},"result":{"type":"string"},"source":{"type":"string"},"calendar":{"type":"string"},"coverage":{"type":"array","items":{"type":"string"}},"provenance":{"type":"object","description":"Additive evidence block (sg-provenance/1): per-fact source, retrieval time, limits; no score or verdict. Full schema in OpenAPI."},"weekend_days":{"type":"array","items":{"type":"string"}},"holidays_skipped":{"type":"array","items":{"type":"object"}}},"description":"Business-day answer for the calendar: is_business_day / result date / count / holiday list, with coverage years"},"receipt":{"type":"object","required":["v","endpoint_id","ts","price","tx_hash","request_hash","response_hash","log_seq","sig"],"properties":{"evidence":{"type":"object","description":"Signed evidence (see llms.txt)"}},"description":"Ed25519-signed receipt; verify free at POST /v1/verify-receipt. New receipts also carry a signed `evidence` object."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"op":"add","days":3,"start":"2026-12-23","result":"2026-12-29","source":"python-holidays (MIT) public/financial holiday data; observed-day rules as implemented ...","calendar":"US-NY","coverage":["2025-01-01"],"weekend_days":["Sun"],"holidays_skipped":[{"date":"2026-12-25","holiday":"Christmas Day"}]},"receipt":{"v":1,"ts":"2026-10-22T09:00:00Z","sig":"hex","price":{"asset":"USDC","amount":"1000","network":"eip155:84532"},"log_seq":1,"tx_hash":"0x..","endpoint_id":"business-days-v1","request_hash":"hex","response_hash":"hex"}}},"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_SogFN7ZEj_2o1jucPG0_b","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":"Check if a date is a business day, add/subtract business days, count business days between dates, or list public holidays for 250 countries, 630 subdivisions, and 31 stock exchanges (2025–2030).","exampleAgentPrompt":"Can you add 3 business days to December 23 2026 using the US-NY calendar and tell me what date the payment is due?","exampleUseCases":[{"title":"T+2 trade settlement date","prompt":"We executed a trade on December 23 2026 on the NYSE — what is the T+2 settlement date? Use the FIN-XNYS exchange calendar."},{"title":"SLA due date for customer support","prompt":"A support ticket was opened on January 15 2026. Our SLA says we must respond within 5 business days. What's the due date using the US calendar?"},{"title":"Holiday planning for EU operations","prompt":"Can you list all public holidays in Germany for 2026 so I can plan around them for our EU office operations?"}],"resultDescription":"A JSON object with the operation result (e.g. is_business_day boolean, computed result date, business day count, or list of holidays), along with metadata including the calendar used, weekend days, holidays skipped, and coverage years. An Ed25519-signed receipt with price, transaction hash, and request/response hashes is also returned for auditability.","failureModes":["Invalid date format (not YYYY-MM-DD) returns a validation error","Unsupported calendar code returns an error (only 250 countries, 630 subdivisions, 31 exchanges supported)","Year out of supported range (outside 2025–2030) for op=list returns an error","Missing required 'op' parameter defaults to 'check'; missing 'end' for op=between returns an error","days value out of range (|days|>1000) for op=add returns a validation error","Payment failure (insufficient USDC balance) results in 402 response with no data"],"whenToPreferThis":"Choose this endpoint when you need authoritative, multi-jurisdiction business day calculations covering 250 countries, regional subdivisions (e.g. US-NY, GB-ENG), and 31 stock exchanges with coverage through 2030. Ideal for financial settlement (T+N), SLA tracking, and due date computation where a signed audit receipt is required. Prefer over generic date libraries when jurisdiction-specific public holiday awareness and verifiable receipts are mandatory.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:40:17.119Z","isFirstParty":false,"canonicalSlug":"business-days-and-holidays-9ea17d93"}