{"uid":"cap_aOGaJdC-zyKwaFjCrLAJZ","slug":"japan-business-day-api-find-auspicious-dates-by-rokuyo-00fcaeef","name":"Japan Business Day API – Find Auspicious Dates by Rokuyo","description":"Find auspicious dates in Japan: list days in a range (up to 366 days) matching rokuyo (e.g. taian) and optional weekdays (e.g. sat,sun) - for scheduling weddings, moving, contract signing and ceremonies.","url":"https://japan-business-day-api.matchan962.workers.dev/v1/koyomi/find?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":["from","to"],"properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"},"rokuyo":{"type":"string","description":"Comma-separated: taian,shakko,sensho,tomobiki,sakimake,butsumetsu (default taian)"},"weekdays":{"type":"string","description":"Optional comma-separated weekdays, e.g. sat,sun"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_xhU-7tmiSuYBDiYcQqBby","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 dates within a range (up to 366 days) that match specified rokuyo lucky-day types and optional weekday filters, for scheduling ceremonies and important events in Japan.","exampleAgentPrompt":"Find all taian days that fall on a Saturday or Sunday between March 1 and June 30, 2025 — I'm trying to pick an auspicious weekend for a wedding in Japan.","exampleUseCases":[{"title":"Wedding date selection in Japan","prompt":"I'm planning a wedding in Japan and need to find all taian Saturdays and Sundays between April 1 and September 30, 2025 so we can pick the most auspicious date."},{"title":"Auspicious moving day finder","prompt":"We're planning to move apartments in Tokyo. Can you find all taian days between July 1 and August 31, 2025? Weekday or weekend is fine."},{"title":"Contract signing ceremony scheduling","prompt":"We need to sign an important business contract in Japan on a lucky day. Please find all taian and sensho days between November 1 and December 31, 2025 that fall on a weekday (mon through fri)."}],"resultDescription":"A list of dates within the requested range that satisfy both the specified rokuyo type(s) and optional weekday constraints, allowing event planners to identify culturally auspicious days in the Japanese traditional calendar.","failureModes":["Date range exceeds 366 days — API rejects with an error","Invalid rokuyo value provided — unrecognized enum returns error","Invalid date format (non-ISO date strings) causes validation failure","No matching dates found — returns empty list","from date is after to date — likely returns error or empty result"],"whenToPreferThis":"Use this endpoint when you need to find specific auspicious Japanese calendar days (rokuyo) within a date range, especially when filtering by lucky-day type and/or weekday. Ideal for wedding planners, real-estate agents, legal professionals, or any scheduling application that must respect Japanese cultural calendar conventions. Prefer this over a generic calendar API when rokuyo classification is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:41:12.364Z","isFirstParty":false,"canonicalSlug":"japan-business-day-api-find-auspicious-dates-by-rokuyo-00fcaeef"}