{"uid":"cap_OWqLB56bolSxuJ4N4nfos","slug":"japan-business-day-api-list-holidays-0a54910b","name":"Japan Business Day API – List Holidays","description":"List all Japanese national holidays (JA/EN names) for a year, from official Cabinet Office data.","url":"https://japan-business-day-api.matchan962.workers.dev/v1/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"},"calendar":{"enum":["national","bank"],"type":"string","description":"national = weekends + Japanese national holidays; bank = also Dec 31 - Jan 3 (bank holidays)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"year":2027,"holidays":[{"date":"2027-01-01","name":"元日","nameEn":"New Year's Day"}]}},"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_-B_iYFcGprevKT75cUUyL","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 a list of Japanese national or bank holidays for a given year, with dates and names in Japanese and English.","exampleAgentPrompt":"Can you get me the full list of Japanese national holidays for 2025, including the official Japanese and English names?","exampleUseCases":[{"title":"Payroll processing holiday calendar","prompt":"I need a complete list of all Japanese bank holidays for 2025 so I can exclude them from our payroll processing schedule — can you pull that for me?"},{"title":"Golden Week travel planning","prompt":"What are all the official Japanese national holidays in 2026? I want to see the full year so I can plan around Golden Week and other busy travel periods."},{"title":"Business SLA calculation setup","prompt":"Can you fetch all Japanese bank holidays for 2027, including the Dec 31 to Jan 3 year-end closures? I need to configure our SLA calendar to skip non-business days."}],"resultDescription":"A JSON object containing the requested year and an array of holiday objects, each with a date (YYYY-MM-DD), a Japanese name (e.g. 元日), and an English name (e.g. New Year's Day). For 'bank' calendar, year-end bank closure days (Dec 31–Jan 3) are also included.","failureModes":["Missing required 'year' parameter returns a 400 error","Invalid calendar enum value (not 'national' or 'bank') may return a 400 error","Payment not completed or invalid x402 signature returns HTTP 402 with payment requirements","Year outside supported data range may return an empty holidays array or error","Network timeout from the Cloudflare Worker edge environment"],"whenToPreferThis":"Use this endpoint when you need a complete list of all Japanese holidays for a full calendar year, especially when you need both national and bank-specific holidays. It is ideal for batch calendar setup, payroll configuration, or any system that needs to enumerate all non-business days upfront rather than checking individual dates one by one.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:41:02.882Z","isFirstParty":false,"canonicalSlug":"japan-business-day-api-list-holidays-0a54910b"}