{"uid":"cap_JLKPfKjrg1UFnSAw23ugx","slug":"japan-business-day-api-payment-due-date-calculator-b308582d","name":"Japan Business Day API – Payment Due Date Calculator","description":"Japanese payment terms calculator (shimebi/shiharaibi): e.g. 'month-end close, paid end of next month', shifted to the previous/next business day when the due date is a weekend or Japanese holiday. Supports bank calendar (Dec 31 - Jan 3).","url":"https://japan-business-day-api.matchan962.workers.dev/v1/payment-due-date?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","closing","payDay"],"properties":{"date":{"type":"string","format":"date","description":"Transaction or invoice date"},"adjust":{"enum":["previous","next","none"],"type":"string"},"payDay":{"type":"string","description":"Payment day of month: 1-31 or 'end'"},"closing":{"type":"string","description":"Closing day of month: 1-31 or 'end'"},"calendar":{"enum":["national","bank"],"type":"string","description":"national = weekends + Japanese national holidays; bank = also Dec 31 - Jan 3 (bank holidays)"},"monthOffset":{"type":"integer","maximum":3,"minimum":0,"description":"Months after closing (1 = next month)"}}}},"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_8dsz43Z7RKHuxy543L8Rj","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":"Calculates Japanese payment due dates based on shimebi (closing day) and shiharaibi (payment day) conventions, adjusting for weekends and Japanese holidays.","exampleAgentPrompt":"For an invoice dated November 15, 2024, with a month-end closing and payment due at the end of the following month, what is the actual payment due date in Japan — using the bank calendar and shifting to the next business day if it falls on a holiday?","exampleUseCases":[{"title":"Accounts payable automation for Japanese vendors","prompt":"We received a Japanese invoice dated October 10, 2024. Our payment terms are 20th-of-month closing with payment on the last day of the following month. Using the bank holiday calendar, what is the actual payment due date, shifted to the next business day if needed?"},{"title":"Month-end close invoicing for SaaS billing","prompt":"Our Japanese client has a month-end close and pays on the 25th of the next month. For a transaction on December 15, 2024, when is the due date, adjusted to the previous business day if it falls on a weekend or Japanese national holiday?"},{"title":"ERP payment schedule generation","prompt":"I need to calculate when payments are due for a batch of invoices with a 15th-of-month close and end-of-month payment terms, one month after close. For a transaction date of January 5, 2025, what is the due date using the national holiday calendar with adjustment to the next business day?"}],"resultDescription":"Returns the calculated payment due date as a date, adjusted for weekends and Japanese holidays (national or bank calendar) according to the specified closing day, payment day, and month offset.","failureModes":["Missing required query parameters (date, closing, payDay) returns a 400 error","Invalid date format returns a parsing error","Month offset outside 0-3 range is rejected","Unsupported adjust or calendar enum values return a validation error","Network or worker downtime returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need to compute Japanese B2B payment due dates respecting shimebi/shiharaibi conventions and Japanese public or bank holidays. It is purpose-built for Japanese accounts payable workflows, ERP integrations, and billing systems that must handle holiday-shifted due dates — superior to generic date arithmetic or non-Japan-aware business day calculators.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:45:44.223Z","isFirstParty":false,"canonicalSlug":"japan-business-day-api-payment-due-date-calculator-b308582d"}