{"uid":"cap_oLswKTPVZ2jcNK-5whsRV","slug":"torii-japan-business-calendar-public-holidays-lookup-c07005cf","name":"Torii Japan Business Calendar — Public Holidays Lookup","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/holidays?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":["year"],"properties":{"year":{"type":"integer","maximum":2100,"minimum":1955,"description":"Calendar year (Gregorian). Accepted range is 1955-2100, but only years covered by the upstream Cabinet Office CSV can be answered; years outside the covered range 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":{"year":2026,"holidays":[{"date":"2026-01-01","name":"元日"},{"date":"2026-01-12","name":"成人の日"},{"date":"2026-02-11","name":"建国記念の日"},{"date":"2026-02-23","name":"天皇誕生日"},{"date":"2026-03-20","name":"春分の日"},{"date":"2026-04-29","name":"昭和の日"},{"date":"2026-05-03","name":"憲法記念日"},{"date":"2026-05-04","name":"みどりの日"},{"date":"2026-05-05","name":"こどもの日"},{"date":"2026-05-06","name":"休日"},{"date":"2026-07-20","name":"海の日"},{"date":"2026-08-11","name":"山の日"},{"date":"2026-09-21","name":"敬老の日"},{"date":"2026-09-22","name":"休日"},{"date":"2026-09-23","name":"秋分の日"},{"date":"2026-10-12","name":"スポーツの日"},{"date":"2026-11-03","name":"文化の日"},{"date":"2026-11-23","name":"勤労感謝の日"}]},"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_n5-KW48SPszr58QpkOQ0u","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":"Returns all Japanese national public holidays for a given Gregorian calendar year, sourced from the Japanese Cabinet Office.","exampleAgentPrompt":"What are all the public holidays in Japan for 2026? I need the official list from the Cabinet Office.","exampleUseCases":[{"title":"Payroll automation holiday exclusion","prompt":"I'm building a payroll system for our Japan office — can you pull the full list of Japanese national holidays for 2025 so I can exclude them from the working-day count?"},{"title":"Scheduling app Japan holiday sync","prompt":"Our scheduling tool needs to block out all Japanese public holidays for 2027 so employees don't get assigned shifts on those days — can you fetch the official list?"},{"title":"Cross-border project timeline planning","prompt":"I'm planning a project timeline that involves our Tokyo team. Can you get me all the Japanese national holidays for 2024 so I know which dates to avoid for deadlines?"}],"resultDescription":"A JSON object containing the year queried and an array of holiday objects, each with a date (YYYY-MM-DD) and name in Japanese (e.g. '元日'). Also includes metadata: source name (内閣府), license (PDL-1.0), attribution text, fetched_at timestamp, and a staleness flag.","failureModes":["Year outside covered Cabinet Office CSV range returns 404 (not charged)","Year outside 1955–2100 schema range returns 4xx (not charged)","Missing required 'year' query parameter returns 4xx (not charged)","x402 payment signature invalid or missing: returns 402 with payment requirements","Upstream Cabinet Office data temporarily unavailable: may return 5xx (not charged)"],"whenToPreferThis":"Choose this endpoint when you specifically need official Japanese national public holidays sourced from the Japanese Cabinet Office, with per-year resolution and coverage from 1955 to 2100. It is ideal for payroll, scheduling, and business calendar automation in Japan contexts. It suits pay-per-call agent workflows where you only pay for successful results, and where 4xx/5xx errors are cost-free. Prefer it over general calendar APIs when authoritative Japanese government sourcing and Japanese-language holiday names are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:39:18.952Z","isFirstParty":false,"canonicalSlug":"torii-japan-business-calendar-public-holidays-lookup-c07005cf"}