{"uid":"cap_L3t0lMHLu5VkaZltIKepG","slug":"business-day-calculator-api-705318c2","name":"Business Day Calculator API","description":"Calendar and Japan data APIs for AI agents: worldwide holidays and business days (200+ countries), plus Japanese text-to-structure (address, name, bank, company normalization). Pay per call in USDC via x402, no API key.","url":"https://x402-ja-api.onrender.com/v1/business-day","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":["country"],"properties":{"add":{"type":"integer","default":0,"maximum":2000,"minimum":-2000,"description":"Business days to add (negative = go back)"},"date":{"type":"string","format":"date","description":"Base date YYYY-MM-DD (default: today UTC)"},"region":{"type":"string","maxLength":10,"description":"Optional subdivision code"},"country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO 3166-1 alpha-2 country code"},"weekend":{"type":"string","description":"Override weekend as weekday numbers, 0=Sunday (e.g. 5,6 for Fri-Sat). Default: the country's customary weekend"},"calendar":{"enum":["standard","bank"],"type":"string","default":"standard","description":"bank = also treat bank holidays as closed"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"add":1,"date":"2026-12-24","region":null,"result":"2026-12-28","country":"DE","weekday":"Thursday","weekend":[6,0],"holidays":[],"isWeekend":false,"isBusinessDay":true,"nextBusinessDay":"2026-12-28","previousBusinessDay":"2026-12-23"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1m-4Pnas6SXYKQb033DEF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates business days for a given country and date, with support for holidays, custom weekends, and adding/subtracting business days.","exampleAgentPrompt":"What date is 5 business days after December 24, 2026 in Germany? Use the standard calendar.","exampleUseCases":[{"title":"Payment settlement date calculation","prompt":"I need to know what date a payment will settle if it's initiated on March 14, 2025 and takes 3 business days to clear in the UK — make sure you skip weekends and holidays."},{"title":"SLA deadline for customer support","prompt":"Our SLA says we have 10 business days to resolve a support ticket opened on January 20, 2025 in France. What is the deadline date?"},{"title":"Checking if a date is a working day in Japan","prompt":"Is April 29, 2025 a business day in Japan? And if not, what's the next business day after it?"}],"resultDescription":"A JSON object containing the resolved result date after adding/subtracting business days, the weekday name, whether the base date is a business day or weekend, the next and previous business days, the weekend days for that country, and any public holidays on or between dates.","failureModes":["Missing required 'country' query parameter returns an error","Invalid country code (not ISO 3166-1 alpha-2) causes a validation failure","Date format not in YYYY-MM-DD format returns a parse error","'add' value outside -2000 to 2000 range is rejected","Payment not provided or insufficient USDC balance results in 402 Payment Required","Invalid region/subdivision code may return an error or be silently ignored"],"whenToPreferThis":"Choose this endpoint when you need to calculate business days across 200+ countries with accurate public holiday data, custom weekend configurations, or banking holiday support — especially when you need to add or subtract a specific number of business days from a date. It is ideal for scheduling, SLA tracking, financial settlement calculations, and delivery date estimation globally, and requires no API key (pay-per-call in USDC via x402).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:28.517Z","isFirstParty":false}