{"uid":"cap_AfJK0pB9VRuUYvvLBa8Zu","slug":"japan-business-calendar-is-business-day-3eaa3387","name":"Japan Business Calendar – Is Business Day","description":"Tell whether a given date is a Japanese business day. Japanese national holidays and business-day calculations derived from the Cabinet Office official CSV. Returns holidays for a given year, plus business-day arithmetic used by invoicing, logistics and HR systems in Japan.","url":"https://torii-gateway-production.ichis-lab.workers.dev/v1/jp-biz-calendar/is-business-day?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"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date to check, in YYYY-MM-DD (ISO 8601 calendar date, interpreted in UTC). Dates outside the years covered by the upstream CSV return 404 and are not charged."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"date":"2026-01-05","is_business_day":true},"meta":{"stale":false,"source_id":"jp-biz-calendar","terms_url":"https://www.cao.go.jp/notice/rule.html","fetched_at":"2026-09-21T03:00:00.000Z","license_id":"PDL-1.0","attribution":"出典:内閣府ウェブサイト(https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html)を加工して作成","source_name":"内閣府「国民の祝日について」","freshness_class":"static"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P8MbawvQiic8Rfg_4X1CV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 Japanese business day, accounting for national holidays from the Cabinet Office official CSV.","exampleAgentPrompt":"Can you check if January 8, 2024 is a business day in Japan? I need to know if we can process payments that day.","exampleUseCases":[{"title":"Invoice due date validation for Japan","prompt":"We're generating invoices for our Japanese clients and the payment due date falls on 2024-11-04. Is that actually a business day in Japan, or do we need to push it to the next working day?"},{"title":"Logistics shipment scheduling","prompt":"We have a shipment scheduled to arrive at our Tokyo warehouse on 2025-02-11. Can you check if that's a business day in Japan so we know if staff will be available to receive it?"},{"title":"HR payroll processing date check","prompt":"Our Japan payroll is supposed to go out on 2024-09-16. Can you confirm that's a valid business day in Japan before we submit the run?"}],"resultDescription":"Returns a boolean or structured response indicating whether the queried date is a Japanese business day, along with any relevant holiday name if the date is a national holiday. Dates outside the range covered by the Cabinet Office CSV return a 404 and are not charged.","failureModes":["Date outside supported year range → 404 Not Found, no charge","Invalid date format (not YYYY-MM-DD) → 400 Bad Request","Network/worker timeout → 5xx error","Weekends with no holiday data may require caller to also check day-of-week separately"],"whenToPreferThis":"Use this endpoint when you need authoritative Japanese national holiday data sourced from the official Cabinet Office CSV for business-day logic in invoicing, payroll, logistics, or HR systems operating in Japan. Prefer it over hardcoded holiday lists or generic calendar libraries that may miss Japan-specific substitution holidays or recently added observances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:36:21.999Z","isFirstParty":false,"canonicalSlug":"japan-business-calendar-is-business-day-3eaa3387"}