{"openapi":"3.0.3","info":{"title":"Kaisha — Japan Company Registry API","version":"1.0.0","description":"Official-data lookups for Japanese companies, priced per call via x402 (USDC on Base & Solana). Includes the only Japan qualified-invoice (適格請求書) registration-number verification on x402 — checked against the National Tax Agency dataset. Also: resolve company names / 13-digit corporate numbers to registry records, and compute Japanese business days & national holidays. No API keys — pay per request with x402.","contact":{"email":"hp.vladic@gmail.com"}},"servers":[{"url":"https://kaisha-api.hp-vladic.workers.dev"}],"paths":{"/resolve":{"get":{"summary":"Resolve a Japanese company to its official registry record ($0.005 per call, x402)","description":"Query by company name (fuzzy normalization for legal forms, zenkaku/hankaku, kana) or 13-digit corporate number. Returns corporate number, canonical name, head-office address, entity type, active/closed status. Source: National Tax Agency corporate number registry (~5.8M corporations).","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Company name (Japanese) or 13-digit corporate number"},{"name":"prefecture","in":"query","required":false,"schema":{"type":"string"},"description":"Optional prefecture filter, e.g. 東京都"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25}}],"responses":{"200":{"description":"Registry records (JSON)"},"402":{"description":"Payment required (x402)"}}}},"/invoice/verify":{"get":{"summary":"Verify a Japan invoice registration number against the NTA dataset ($0.01 per call, x402)","description":"Checks a qualified-invoice-issuer registration number (T + 13 digits) for existence, active/cancelled status, registration date and — for corporations — registered name and corporate number. Includes corporate-number checksum validation.","parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string"},"description":"Registration number, e.g. T1180301018771 (T optional)"}],"responses":{"200":{"description":"Verification result (JSON)"},"402":{"description":"Payment required (x402)"}}}},"/companies/events":{"get":{"summary":"Daily feed of Japanese corporate events — new companies, closures, moves ($0.01 per call, x402)","description":"Registry events from National Tax Agency daily diff data. type=new returns newly registered companies (新設法人) — the only x402 source for discovering newly founded Japanese companies. Ideal for lead-gen and market-monitoring agents.","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["new","renamed","moved","closed","merged","all"]}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":60}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"prefecture","in":"query","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Event list (JSON)"},"402":{"description":"Payment required (x402)"}}}},"/calendar/holidays":{"get":{"summary":"Japanese national holidays by year ($0.002 per call, x402)","parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"integer","minimum":1955,"maximum":2027}}],"responses":{"200":{"description":"Holiday list (JSON)"},"402":{"description":"Payment required (x402)"}}}},"/calendar/business-days":{"get":{"summary":"Japanese business-day check / add / count ($0.002 per call, x402)","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"add","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":365}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"saturday_off","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"new_year_break","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Business-day result (JSON)"},"402":{"description":"Payment required (x402)"}}}},"/catalog":{"get":{"summary":"Machine-readable service catalog (free)","security":[],"responses":{"200":{"description":"Catalog (JSON)"}}}},"/sample":{"get":{"summary":"Free example output for every paid endpoint — try before you pay","description":"Returns the exact JSON shape each paid endpoint produces, as a static example. No payment, no lookup.","security":[],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["resolve","invoice","events","holidays","business-days"]},"description":"Show only one endpoint’s example. Omit for all of them."}],"responses":{"200":{"description":"Example output (JSON)"}}}}}}