{"uid":"cap_Y32WJ4M49S9Eh-uOLRF8s","slug":"torii-japan-business-calendar-add-business-days-d06fbbb5","name":"Torii Japan Business Calendar — Add Business Days","description":"Pay-per-call HTTP APIs for Japanese public data, metered with x402 (HTTP 402 + PAYMENT-SIGNATURE). Send a plain GET to receive 402 with the price and payment requirements, then resend the request with a signed payment. Only 2xx responses are charged; 4xx and 5xx are free. Per-operation payment metadata is published under the `x-payment-info` extension.","url":"https://torii-gateway-production.ichis-lab.workers.dev/v1/jp-biz-calendar/add-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"},"queryParams":{"type":"object","required":["date","n"],"properties":{"n":{"type":"integer","maximum":3650,"minimum":-3650,"description":"Business days to add; negative goes backwards. 0 returns the base date if it is a business day, else the next one (never the previous). From a non-business base date, n=1 lands on the same day as n=0."},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Base date, in YYYY-MM-DD (ISO 8601 calendar date, interpreted in UTC). Results 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":{"n":5,"date":"2026-01-05","result":"2026-01-13"},"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_CoGSvQhkeclj0JDIPNCsn","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":"Given a base date and an integer N, returns the Japanese business date that is N business days later (or earlier), accounting for Japanese national holidays.","exampleAgentPrompt":"What date is 5 Japanese business days after 2026-01-05? Use the Japan business calendar that handles national holidays.","exampleUseCases":[{"title":"Japanese invoice payment deadline calculator","prompt":"Our supplier invoice is dated 2026-03-25 and payment terms are net 10 business days in Japan — what's the actual due date accounting for spring holidays?"},{"title":"T+2 settlement date for Japanese equity trade","prompt":"I executed a stock trade on the Tokyo Stock Exchange on 2026-04-28. What is the T+2 settlement date, skipping Japanese national holidays and weekends?"},{"title":"Project deadline offset after Golden Week","prompt":"Our project kick-off is 2026-04-30 and the first deliverable is due 7 business days later — what calendar date is that, considering Golden Week?"}],"resultDescription":"A JSON object containing the computed result date (ISO 8601), the original base date, the N value applied, plus metadata fields: whether the data is stale, the source name (Cabinet Office of Japan), license ID, attribution string in Japanese, terms URL, and the timestamp the data was fetched.","failureModes":["404 (not charged): requested result date falls outside the years covered by the upstream holiday CSV","402: payment not yet sent — caller must resend with a valid x402 PAYMENT-SIGNATURE header","400: missing or malformed required query parameters (date not in YYYY-MM-DD format, n out of -3650..3650 range)","5xx: upstream gateway error (not charged)"],"whenToPreferThis":"Use this endpoint when you need to offset a date by a precise number of Japanese business days and must correctly skip Japanese national holidays (not just weekends). It is ideal for financial settlement calculations (T+N), payroll due dates, contract deadlines, and logistics scheduling within Japan. Prefer it over generic business-day libraries that lack Japan-specific holiday data, and over the sibling 'is-business-day' endpoint when you need forward/backward date arithmetic rather than a simple yes/no check.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T18:31:24.492Z","isFirstParty":false,"canonicalSlug":"torii-japan-business-calendar-add-business-days-d06fbbb5"}