{"openapi":"3.1.0","info":{"title":"Torify API","description":"42 Japanese locale APIs for AI agents: invoice compliance (NTA), corporate number verification (法人番号), address normalization, wareki date conversion, phone normalization, and 37 more. Pay $0.02/call USDC/call via x402 on Base L2 — no signup, no subscription required. Free MCP tier for Claude Desktop & Cursor available at https://torify.dev. Discovered on x402scan · Smithery (100/100) · MCP.so · a2aregistry · Anthropic Official MCP Registry.","version":"0.1.0","contact":{"url":"https://torify.dev"},"x-guidance":"All /v1/* endpoints require x402 payment (USDC on Base L2, network eip155:8453). Send a request without X-PAYMENT header to receive a 402 challenge with payment instructions. Alternatively use X-API-Key header for monthly subscription access ($19/mo). Free endpoints: /health, /openapi.json, /.well-known/x402, /v1/wareki/convert/bulk. /v1/invoice/validate/bulk requires Trial key or x402 $0.50/req."},"servers":[{"url":"https://torify.dev","description":"Current server"}],"tags":[{"name":"Calendar & Dates","description":"Japanese era dates, public holidays, statutory rest days, and age/school-year calculations"},{"name":"Legal & Tax","description":"Invoice validation & NTA registry lookup, consumption tax calculation, and electronic bookkeeping compliance"},{"name":"Corporate & KYC","description":"Corporate number (法人番号) lookup, My Number validation, and industry classification"},{"name":"Geo & Address","description":"Postal code → address lookup, address normalization, JIS X 0402 region codes, and WGS84 ↔ JGD2011 coordinate conversion"},{"name":"Finance & Banking","description":"Zengin bank/branch lookup, bank search and listing, transfer format validation, Japan Post account conversion, and 3D Secure applicability"},{"name":"Text & Names","description":"Kanji reading, kana conversion, NFKC normalization, name romanization, name validation, and surname/given-name splitting"},{"name":"Identity & Validation","description":"Passport, driver license, social insurance, license plate, JAN barcode, MEXT school code, and Japanese phone number validation"},{"name":"Diagnostics","description":"Free utility endpoints for connection diagnostics"}],"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 payment protocol. Base64-encoded PaymentPayload JSON. Omit to receive a 402 response with payment instructions."},"trialKey":{"type":"apiKey","in":"header","name":"X-Trial-Key","description":"Free trial key (100 calls/month). Obtain via POST /v1/trial/signup. Format: trial_<32 hex chars>. Resets on the 1st of each calendar month."},"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Pro/Enterprise subscription API key. 10,000 (Pro) or 1,000,000 (Enterprise Fair Use) calls/month within plan limit."}},"schemas":{"ApiError":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}},"X402Required":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}},"paths":{"/v1/wareki/convert":{"get":{"operationId":"warekiConvert","summary":"Japanese era ↔ Gregorian conversion","description":"[📅 Calendar & Dates] Convert between Japanese wareki (元号) and Gregorian dates. Use when: processing Japanese government documents, parsing legacy database dates, building Japanese-localized forms. Price: $0.02 USDC per call.","tags":["Calendar & Dates"],"security":[{"x402":[]}],"parameters":[{"name":"direction","in":"query","description":"`g2w` = Gregorian to wareki, `w2g` = wareki to Gregorian","schema":{"type":"string","enum":["g2w","w2g"],"default":"g2w"}},{"name":"date","in":"query","description":"Gregorian date in YYYY-MM-DD format (required when direction=g2w)","schema":{"type":"string","format":"date","example":"2019-05-01"}},{"name":"era","in":"query","description":"Era name in Japanese (required when direction=w2g)","schema":{"type":"string","example":"令和"}},{"name":"eraYear","in":"query","description":"Year within the era (required when direction=w2g)","schema":{"type":"integer","example":1}},{"name":"month","in":"query","schema":{"type":"integer","minimum":1,"maximum":12,"example":5}},{"name":"day","in":"query","schema":{"type":"integer","minimum":1,"maximum":31,"example":1}},{"name":"extras","in":"query","required":false,"description":"Set to `true` to include zodiac, sekku, and isSekki fields in response (default: false)","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Conversion result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"era":{"type":"string","example":"令和"},"eraRomaji":{"type":"string","example":"Reiwa"},"eraYear":{"type":"integer","example":1},"eraYearLabel":{"type":"string","example":"元年"},"formatted":{"type":"string","example":"令和元年5月1日"},"extras":{"type":"object","nullable":true,"description":"Present when extras=true; includes zodiac sign, sekku, and solar term info","properties":{"zodiac":{"type":"object","description":"Zodiac sign (十二支)","properties":{"code":{"type":"string","example":"horse"},"ja":{"type":"string","example":"午"},"en":{"type":"string","example":"Horse"}}},"sekku":{"type":"object","nullable":true,"description":"Seasonal festival (節句) if applicable"},"isSekki":{"type":"boolean","description":"Whether the date is a solar term (二十四節気)"}}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/invoice/validate":{"get":{"operationId":"invoiceValidate","summary":"Invoice number format validation (local)","description":"[⚖️ Legal & Tax] Validate format of Japanese invoice registration number (T + 13 digits). Does NOT call NTA API. Use when: pre-validating invoice numbers before NTA API call, form input validation, invoice data import pipelines. Price: $0.02 USDC per call.","tags":["Legal & Tax"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string","example":"T7000012050002"}}],"responses":{"200":{"description":"Validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"input":{"type":"string"},"valid":{"type":"boolean"},"format":{"type":"string","enum":["valid","invalid_prefix","invalid_length","invalid_chars"]},"checkDigit":{"type":"object","properties":{"expected":{"type":"integer"},"actual":{"type":"integer"},"match":{"type":"boolean"}}},"type":{"type":"string","enum":["corporate","individual_or_other"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Missing parameter","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/invoice/verify":{"get":{"operationId":"invoiceVerify","summary":"Invoice number existence verification (NTA API)","description":"[⚖️ Legal & Tax] Verify registration status of invoice number via NTA public API. Returns registrant name, address, registration date. All responses include the mandatory NTA disclaimer. Use when: B2B Japan invoice compliance (適格請求書制度), tax deduction validation, vendor KYC during onboarding. Price: $0.02 USDC per call.","tags":["Legal & Tax"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string","example":"T7000012050002"}}],"responses":{"200":{"description":"Verification result with NTA disclaimer","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"input":{"type":"string"},"registered":{"type":"boolean"},"registrantName":{"type":"string"},"registrantAddress":{"type":"string"},"registrationDate":{"type":"string"},"cancelDate":{"type":"string","nullable":true},"source":{"type":"string","enum":["nta-invoice-kohyo","mock"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid format","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"502":{"description":"NTA API unreachable"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/houjin/lookup":{"get":{"operationId":"houjinLookup","summary":"Japanese corporate number lookup","description":"[🏢 Corporate & KYC] Look up company information by 13-digit corporate number using NTA Corporate Number API. Use when: B2B onboarding, KYC verification, corporate due diligence. Price: $0.02 USDC per call.","tags":["Corporate & KYC"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"13-digit corporate number","schema":{"type":"string","example":"7000012050002"}}],"responses":{"200":{"description":"Company information","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"houjinBangou":{"type":"string","example":"7000012050002"},"name":{"type":"string","example":"国税庁"},"nameKana":{"type":"string"},"nameEn":{"type":"string"},"kind":{"type":"object","properties":{"code":{"type":"string","example":"301"},"ja":{"type":"string","example":"株式会社"},"en":{"type":"string","example":"Kabushiki Kaisha (K.K.)"}}},"address":{"type":"object","properties":{"full":{"type":"string"},"prefecture":{"type":"string"},"city":{"type":"string"},"rest":{"type":"string"},"postalCode":{"type":"string","example":"100-6150"}}},"status":{"type":"string","enum":["active","closed","merged","unknown"]},"lastUpdated":{"type":"string"},"source":{"type":"string","enum":["nta-houjin-bangou","cache","mock"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid number format","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"502":{"description":"NTA API unreachable"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/postal/lookup":{"get":{"operationId":"postalLookup","summary":"Japanese postal code lookup","description":"[🗺️ Geo & Address] Look up address from 7-digit Japanese postal code. Use when: Japanese shipping address auto-fill, e-commerce checkout, address normalization. Price: $0.02 USDC per call.","tags":["Geo & Address"],"security":[{"x402":[]}],"parameters":[{"name":"zipcode","in":"query","required":true,"description":"7-digit postal code (hyphen optional)","schema":{"type":"string","example":"1000001"}},{"name":"all","in":"query","description":"Set to `true` to return all matching towns (some postal codes map to multiple towns)","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Address information","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"zipcode":{"type":"string"},"prefecture":{"type":"string","example":"東京都"},"prefectureKana":{"type":"string","example":"トウキョウト"},"prefectureEn":{"type":"string","nullable":true,"example":"Tokyo","description":"Prefecture name in English"},"city":{"type":"string","example":"千代田区"},"cityKana":{"type":"string","example":"チヨダク"},"cityEn":{"type":"string","nullable":true,"example":"Chiyoda-ku","description":"City name in English"},"town":{"type":"string","example":"千代田"},"townKana":{"type":"string","example":"チヨダ"},"townEn":{"type":"string","nullable":true,"example":"Chiyoda","description":"Town name in English"},"full":{"type":"string","example":"東京都千代田区千代田","description":"Full address string (prefecture + city + town)"},"source":{"type":"string","example":"zipcloud","description":"Data source (zipcloud or cache)"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid or missing postal code","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"404":{"description":"Postal code not found"},"502":{"description":"zipcloud API unreachable"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/name/romanize":{"get":{"operationId":"nameRomanize","summary":"Japanese name romanization (modified Hepburn)","description":"[📝 Text & Names] Convert Japanese name from kana to modified Hepburn romanization (passport-standard). Input must be kana (hiragana or katakana). Use when: passport/visa application forms, international payroll systems, travel booking localization. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"name","in":"query","required":true,"description":"Name in kana","schema":{"type":"string","example":"すずき いちろう"}},{"name":"order","in":"query","description":"Name order","schema":{"type":"string","enum":["family-first","given-first"],"default":"family-first"}}],"responses":{"200":{"description":"Romanized name","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"input":{"type":"string"},"romaji":{"type":"string","example":"SUZUKI ICHIRO"},"order":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Missing or invalid name","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/kanji/to-kana":{"get":{"operationId":"kanjiToKana","summary":"Kanji to kana conversion","description":"[📝 Text & Names] Convert Japanese text containing kanji to hiragana or katakana using Cloudflare Workers AI (Llama 3.3 70B). Text without kanji is passed through unchanged. Use when: furigana generation for name fields, Japanese search index normalization, accessibility text processing. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"text","in":"query","required":true,"schema":{"type":"string","example":"東京都千代田区"}},{"name":"output","in":"query","description":"Output kana type","schema":{"type":"string","enum":["hiragana","katakana"],"default":"hiragana"}}],"responses":{"200":{"description":"Kana reading","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"input":{"type":"string"},"output":{"type":"string","example":"とうきょうとちよだく"},"outputType":{"type":"string","enum":["hiragana","katakana"]},"source":{"type":"string","enum":["workers-ai","passthrough"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Missing text","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/tax/calculate":{"get":{"operationId":"taxCalculate","summary":"Consumption tax calculation (10% standard / 8% reduced)","description":"[⚖️ Legal & Tax] Calculate Japanese consumption tax (10% standard / 8% reduced). Use when: Japan checkout/POS systems, invoice processing, payroll calculations. Price: $0.02 USDC per call.","tags":["Legal & Tax"],"security":[{"x402":[]}],"parameters":[{"name":"amount","in":"query","required":true,"description":"Pre-tax amount","schema":{"type":"number","example":1000}},{"name":"category","in":"query","description":"Tax rate category","schema":{"type":"string","enum":["standard","reduced","food","alcohol","luxury"],"default":"standard"}},{"name":"rounding","in":"query","description":"Rounding method for tax amount","schema":{"type":"string","enum":["floor","ceil","round"],"default":"floor"}},{"name":"taxIncluded","in":"query","required":false,"description":"Set to `true` if the input amount already includes tax (tax-inclusive calculation). Default: false","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Tax calculation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"amount":{"type":"number","example":1000,"description":"Input amount"},"category":{"type":"string","example":"standard","description":"Resolved tax category (standard, reduced, food, alcohol, luxury)"},"taxRate":{"type":"number","example":0.1,"description":"Applied tax rate (e.g. 0.1 for 10%)"},"taxAmount":{"type":"number","example":100,"description":"Calculated tax amount"},"total":{"type":"number","example":1100,"description":"Total including tax"},"taxIncluded":{"type":"boolean","example":false,"description":"Whether calculation was tax-inclusive"},"basePrice":{"type":"number","example":10000,"description":"Pre-tax base price (present when taxIncluded=true)"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/phone/validate":{"get":{"operationId":"phoneValidate","summary":"Validate and normalize Japanese phone number to E.164","description":"[🆔 Identity & Validation] Validate and normalize a Japanese phone number to E.164. Use when: user registration form validation, CRM contact deduplication, Japan SMS notification systems. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"phone","in":"query","required":true,"description":"Phone number to validate","schema":{"type":"string","example":"03-1234-5678"}}],"responses":{"200":{"description":"Phone number validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"type":{"type":"string","nullable":true,"enum":["mobile","fixed","freephone","toll","ip"],"description":"Phone number type"},"typeEn":{"type":"string","nullable":true,"description":"Phone number type in English"},"normalized":{"type":"string","nullable":true,"description":"Normalized phone number (e.g. 03-1234-5678)"},"e164":{"type":"string","nullable":true,"example":"+81312345678","description":"E.164 format"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/address/normalize":{"get":{"operationId":"addressNormalize","summary":"Parse Japanese address into structured components","description":"[🗺️ Geo & Address] Parse and normalize a Japanese address into structured components. Use when: address data cleansing, shipping label generation, real estate listing normalization. Price: $0.02 USDC per call.","tags":["Geo & Address"],"security":[{"x402":[]}],"parameters":[{"name":"address","in":"query","required":true,"description":"Japanese address string to parse","schema":{"type":"string","example":"東京都千代田区千代田1-1"}}],"responses":{"200":{"description":"Structured address components","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"original":{"type":"string"},"prefecture":{"type":"string","example":"東京都"},"city":{"type":"string","example":"千代田区"},"town":{"type":"string","example":"千代田"},"rest":{"type":"string","example":"1-1"},"normalized":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/holiday/check":{"get":{"operationId":"holidayCheck","summary":"Check Japanese public holiday status","description":"[📅 Calendar & Dates] Check if a date is a Japanese public holiday. Use when: scheduling meetings in Japan, calculating business days, payment deadline determination. Price: $0.02 USDC per call.","tags":["Calendar & Dates"],"security":[{"x402":[]}],"parameters":[{"name":"date","in":"query","required":true,"description":"Date in YYYY-MM-DD format","schema":{"type":"string","format":"date","example":"2024-01-01"}},{"name":"year","in":"query","required":false,"description":"Year as integer — if provided, returns full list of holidays for that year","schema":{"type":"integer","example":2024}},{"name":"nextBusinessDay","in":"query","required":false,"description":"Set to `true` to include the next business day when the queried date is a holiday or weekend","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Holiday status or full year list","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"date":{"type":"string","format":"date"},"isHoliday":{"type":"boolean"},"name":{"type":"string","example":"元日","nullable":true},"nameEn":{"type":"string","example":"Children's Day","nullable":true,"description":"Holiday name in English (present when isHoliday=true)"},"type":{"type":"string","example":"national","nullable":true},"nextBusinessDay":{"type":"string","format":"date","nullable":true,"example":"2026-05-07","description":"Next business day (present when nextBusinessDay=true and date is holiday/weekend)"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/legal-holiday/check":{"get":{"operationId":"legalHolidayCheck","summary":"Check Japanese statutory rest day (Labor Standards Act Art. 35)","description":"[📅 Calendar & Dates] Determine whether a given date falls on the company-designated statutory rest day (法定休日) under Japan's Labor Standards Act Article 35. Returns overtime premium rates (35% legal holiday vs 25% other rest day). Use when: payroll processing, EOR compliance, shift management systems. Price: $0.02 USDC per call.","tags":["Calendar & Dates"],"security":[{"x402":[]}],"parameters":[{"name":"date","in":"query","required":true,"description":"Date in YYYY-MM-DD format","schema":{"type":"string","format":"date","example":"2024-05-05"}},{"name":"restDays","in":"query","required":false,"description":"CSV of company-designated rest day-of-week (sun/mon/tue/wed/thu/fri/sat). The first entry is treated as the legal holiday (法定休日), additional entries as non-legal rest days (法定外休日). Default: \"sun\"","schema":{"type":"string","example":"sun,sat"}}],"responses":{"200":{"description":"Legal holiday status and overtime premium rates","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"date":{"type":"string","format":"date"},"dayOfWeek":{"type":"string","example":"sun"},"dayOfWeekJa":{"type":"string","example":"日"},"isLegalHoliday":{"type":"boolean"},"restDays":{"type":"array","items":{"type":"string"}},"overtimePremiumRate":{"type":"number","example":0.35},"overtimePremiumRateLegalNonHoliday":{"type":"number","example":0.25},"legalReference":{"type":"string","example":"Labor Standards Act Article 35 (労働基準法第35条)"},"note":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/school-code/validate":{"get":{"operationId":"schoolCodeValidate","summary":"Validate MEXT school code (13-char format + structural decomposition)","description":"[🆔 Identity & Validation] Validate a Japanese Ministry of Education (MEXT) school code and decompose it into school type (kindergarten/elementary/middle/high/university/etc.), establishment type (national/public/private), and prefecture. Use when: HR academic history input, EdTech enrollment verification, school record management. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"code","in":"query","required":true,"description":"13-character MEXT school code (1 alpha for type + 1 digit for establishment + 2 digits for prefecture + 6 digits for school number + 1 digit check + 2 digits serial)","schema":{"type":"string","example":"B213123456X00"}}],"responses":{"200":{"description":"Validation result with structural decomposition","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"code":{"type":"string","example":"B213123456X00"},"valid":{"type":"boolean"},"schoolType":{"type":"string","example":"elementary","nullable":true},"schoolTypeJa":{"type":"string","example":"小学校","nullable":true},"establishment":{"type":"string","example":"public_prefectural","nullable":true},"prefectureCode":{"type":"string","example":"13","nullable":true},"prefectureJa":{"type":"string","example":"東京都","nullable":true},"schoolNumber":{"type":"string","example":"123456","nullable":true},"checkDigit":{"type":"string","nullable":true},"serialNumber":{"type":"string","example":"00","nullable":true},"reason":{"type":"string","nullable":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/age/calculate":{"get":{"operationId":"ageCalculate","summary":"Calculate age, school year, and era-based age","description":"[📅 Calendar & Dates] Calculate Japanese age, school year, and era-based age. Use when: age-gated service verification, school-year-based benefit calculation, insurance eligibility checks. Price: $0.02 USDC per call.","tags":["Calendar & Dates"],"security":[{"x402":[]}],"parameters":[{"name":"birthdate","in":"query","required":true,"description":"Birth date in YYYY-MM-DD format","schema":{"type":"string","format":"date","example":"1990-04-01"}},{"name":"referenceDate","in":"query","required":false,"description":"Reference date in YYYY-MM-DD format (defaults to today)","schema":{"type":"string","format":"date","example":"2024-04-01"}},{"name":"zodiac","in":"query","required":false,"description":"Include Japanese zodiac (十二支) information in response","schema":{"type":"string","enum":["true","false"],"example":"false"}}],"responses":{"200":{"description":"Age calculation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"birthdate":{"type":"string","format":"date"},"age":{"type":"integer","example":34},"schoolYear":{"type":"string","example":"大学3年生相当"},"eto":{"type":"string","example":"午","nullable":true,"description":"Japanese zodiac character (十二支), present when zodiac=true"},"etoEn":{"type":"string","example":"Horse","nullable":true,"description":"Zodiac sign in English, present when zodiac=true"},"etoYearJa":{"type":"string","example":"午年","nullable":true},"birthEra":{"type":"string","example":"平成2年","nullable":true,"description":"Birth year in Japanese era format"},"referenceEra":{"type":"string","example":"令和6年","nullable":true,"description":"Reference date in Japanese era format"},"gradeCategory":{"type":"string","example":"大学生","nullable":true},"schoolYearLabel":{"type":"string","example":"大学3年生相当","nullable":true},"referenceDate":{"type":"string","format":"date","description":"Actual reference date used for calculation"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/bank/lookup":{"get":{"operationId":"bankLookup","summary":"Look up bank name by Zengin bank code","description":"[💰 Finance & Banking] Look up bank and branch information by Zengin code. Use when: payroll bank validation, transfer destination check, Japanese EOR systems. Price: $0.02 USDC per call.","tags":["Finance & Banking"],"security":[{"x402":[]}],"parameters":[{"name":"bankCode","in":"query","required":true,"description":"4-digit Zengin bank code","schema":{"type":"string","example":"0001"}},{"name":"branchCode","in":"query","required":false,"description":"3-digit branch code","schema":{"type":"string","example":"001"}}],"responses":{"200":{"description":"Bank lookup result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"bankCode":{"type":"string","example":"0001","description":"Bank code (4 digits)"},"bankName":{"type":"string","nullable":true,"example":"みずほ銀行","description":"Bank name in Japanese"},"bankNameEn":{"type":"string","nullable":true,"example":"Mizuho Bank","description":"Bank name in English"},"bankKana":{"type":"string","nullable":true,"example":"ミズホ","description":"Bank name in katakana"},"bankRoma":{"type":"string","nullable":true,"example":"MIZUHO","description":"Bank name in romaji"},"branchCode":{"type":"string","nullable":true,"example":"001","description":"Branch code (3 digits, present when branchCode was provided)"},"branchName":{"type":"string","nullable":true,"example":"本店","description":"Branch name in Japanese"},"branchNameEn":{"type":"string","nullable":true,"example":"Main Branch","description":"Branch name in English"},"branchKana":{"type":"string","nullable":true,"example":"ホンテン","description":"Branch name in katakana"},"branchRoma":{"type":"string","nullable":true,"description":"Branch name in romaji"},"found":{"type":"boolean","description":"Whether bank was found"},"branchFound":{"type":"boolean","nullable":true,"description":"Whether branch was found (present when branchCode was provided)"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/bank/search":{"get":{"operationId":"bankSearch","summary":"Search banks or branches by name (partial match)","description":"[💰 Finance & Banking] Search Japanese financial institutions or their branches by partial name (kanji/kana/romaji). When bankCode is omitted, searches across all banks. When bankCode is specified, searches only that bank's branches. Use when: bank name autocomplete, user-driven bank selection UI, transfer setup wizard. Price: $0.02 USDC per call.","tags":["Finance & Banking"],"security":[{"x402":[]}],"parameters":[{"name":"name","in":"query","required":true,"description":"Partial name to search (1-50 chars, case-insensitive, matches kanji/kana/romaji)","schema":{"type":"string","example":"みずほ"}},{"name":"bankCode","in":"query","required":false,"description":"4-digit Zengin bank code (when set, searches only this bank's branches)","schema":{"type":"string","example":"0001"}},{"name":"limit","in":"query","required":false,"description":"Max number of hits (1-100, default 20)","schema":{"type":"integer","example":20}}],"responses":{"200":{"description":"Search hits","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"query":{"type":"string","example":"みずほ"},"mode":{"type":"string","enum":["bank","branch"],"example":"bank"},"hits":{"type":"array","items":{"type":"object"}},"total":{"type":"integer","example":3},"truncated":{"type":"boolean","example":false}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/bank/list":{"get":{"operationId":"bankList","summary":"List all Japanese financial institutions","description":"[💰 Finance & Banking] Return all Japanese banks (~1,150 institutions including credit unions and JA banks) with code, name, kana, romaji, and branch count. Paginated. Use when: populating bank dropdown menus, building offline bank code lookup tables, data migration of Japanese financial records. Price: $0.02 USDC per call.","tags":["Finance & Banking"],"security":[{"x402":[]}],"parameters":[{"name":"offset","in":"query","required":false,"description":"Pagination offset (default 0)","schema":{"type":"integer","example":0}},{"name":"limit","in":"query","required":false,"description":"Page size (1-500, default 200)","schema":{"type":"integer","example":200}}],"responses":{"200":{"description":"Paginated bank list","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"total":{"type":"integer","example":1152},"banks":{"type":"array","items":{"type":"object"}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/bank/transfer/validate":{"get":{"operationId":"bankTransferValidate","summary":"Validate Japanese bank transfer details (Zengin format)","description":"[💰 Finance & Banking] Validate bank transfer account details in Zengin format. Use when: payroll disbursement validation, B2B payment setup, Japanese EOR bank account verification. Price: $0.02 USDC per call.","tags":["Finance & Banking"],"security":[{"x402":[]}],"parameters":[{"name":"bankCode","in":"query","required":true,"description":"4-digit Zengin bank code","schema":{"type":"string","example":"0001"}},{"name":"branchCode","in":"query","required":true,"description":"3-digit branch code","schema":{"type":"string","example":"001"}},{"name":"accountType","in":"query","required":true,"description":"Account type (`1=普通, 2=当座, 4=貯蓄`). Also accepts aliases: ordinary/futsu/普通, current/toza/当座, savings/chochiku/貯蓄","schema":{"type":"string","enum":["1","2","4"]}},{"name":"accountNumber","in":"query","required":true,"description":"Account number","schema":{"type":"string","example":"1234567"}}],"responses":{"200":{"description":"Transfer validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean","description":"Whether the account information is valid"},"bankCode":{"type":"string","example":"0001","description":"4-digit bank code"},"branchCode":{"type":"string","example":"001","description":"3-digit branch code"},"accountType":{"type":"string","example":"1","description":"Normalized account type code (1=普通, 2=当座, 4=貯蓄)"},"accountTypeName":{"type":"string","example":"普通","description":"Account type name in Japanese"},"accountTypeNameEn":{"type":"string","example":"Ordinary","description":"Account type name in English"},"accountNumber":{"type":"string","example":"0001234","description":"Account number padded to 7 digits"},"isYucho":{"type":"boolean","description":"Whether this is a Japan Post Bank (ゆうちょ) account"},"disclaimer":{"type":"string","description":"免責事項（日本語）: 形式検証のみ、口座実在性非確認"},"disclaimerEn":{"type":"string","description":"Disclaimer (English): Format validation only; account existence not verified"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/yucho/convert":{"get":{"operationId":"yuchoConvert","summary":"Convert Japan Post account (symbol/number) to bank transfer format","description":"[💰 Finance & Banking] Convert Japan Post (ゆうちょ) account to standard bank transfer format. Use when: payroll systems accepting Japan Post accounts, Zengin transfer setup for ゆうちょ customers, financial data migration. Price: $0.02 USDC per call.","tags":["Finance & Banking"],"security":[{"x402":[]}],"parameters":[{"name":"kigo","in":"query","required":true,"description":"5-digit account symbol (記号)","schema":{"type":"string","example":"10010"}},{"name":"bango","in":"query","required":true,"description":"8-digit account number (番号)","schema":{"type":"string","example":"12345671"}}],"responses":{"200":{"description":"Converted bank transfer account details","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"bankNameEn":{"type":"string","example":"Japan Post Bank","description":"Bank name in English"},"kigo":{"type":"string","example":"10010","description":"5-digit account symbol (記号)"},"bango":{"type":"string","example":"12345671","description":"Account number (番号)"},"storeCode":{"type":"string","example":"001","description":"Branch store code (3-digit)"},"storeName":{"type":"string","example":"〇一九","description":"Branch store name"},"accountNumber":{"type":"string","example":"1234567","description":"Standard bank account number (7-digit, padded)"},"note":{"type":"string","description":"Advisory note"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/payment/3ds/check":{"get":{"operationId":"payment3dsCheck","summary":"Determine 3D Secure 2.0 requirement based on MCC and BIN","description":"[💰 Finance & Banking] Check 3D Secure 2.0 requirement for a given MCC and BIN. Use when: e-commerce checkout flow design, payment gateway integration for Japan, fraud risk assessment systems. Price: $0.02 USDC per call.","tags":["Finance & Banking"],"security":[{"x402":[]}],"parameters":[{"name":"merchantCategory","in":"query","required":true,"description":"4-digit Merchant Category Code","schema":{"type":"string","example":"5411"}},{"name":"binNumber","in":"query","required":true,"description":"6-digit Bank Identification Number","schema":{"type":"string","example":"411111"}}],"responses":{"200":{"description":"3D Secure requirement result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"binPrefix":{"type":"string","example":"411111","description":"6-digit Bank Identification Number prefix"},"cardBrand":{"type":"string","nullable":true,"example":"Visa","description":"Detected card brand (Visa, Mastercard, etc.)"},"mcc":{"type":"string","example":"5411","description":"4-digit Merchant Category Code"},"mccName":{"type":"string","nullable":true,"example":"Grocery Stores, Supermarkets","description":"MCC description in English"},"requiresThreeDS2":{"type":"boolean","description":"Whether 3D Secure 2.0 is required"},"note":{"type":"string","description":"Advisory note about 3DS requirement"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/region/lookup":{"get":{"operationId":"regionLookup","summary":"Look up prefecture/municipality by JIS X 0402 code","description":"[🗺️ Geo & Address] Look up prefecture or municipality by JIS X 0402 code. Use when: administrative region validation, geospatial data enrichment, Japanese government form processing. Price: $0.02 USDC per call.","tags":["Geo & Address"],"security":[{"x402":[]}],"parameters":[{"name":"code","in":"query","required":true,"description":"2-digit prefecture code or 5-digit municipality code","schema":{"type":"string","example":"13101"}}],"responses":{"200":{"description":"Region lookup result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"code":{"type":"string","example":"13101"},"prefecture":{"type":"string","nullable":true,"example":"東京都"},"prefectureEn":{"type":"string","nullable":true,"example":"Tokyo"},"city":{"type":"string","nullable":true,"example":"千代田区"},"type":{"type":"string","enum":["prefecture","city","town"],"example":"city"},"note":{"type":"string","nullable":true,"description":"Advisory note for unsupported lookup level"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/coordinate/convert":{"get":{"operationId":"coordinateConvert","summary":"Convert coordinates between WGS84 (GPS) and JGD2011 (Japanese datum)","description":"[🗺️ Geo & Address] Convert geographic coordinates between WGS84 (GPS) and JGD2011 (Japanese datum). Use when: integrating GPS data with Japanese cadastral maps, GIS data migration, drone/survey data processing in Japan. Price: $0.02 USDC per call.","tags":["Geo & Address"],"security":[{"x402":[]}],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number","example":35.6894}},{"name":"lng","in":"query","required":true,"description":"Longitude","schema":{"type":"number","example":139.6917}},{"name":"direction","in":"query","required":true,"description":"Conversion direction","schema":{"type":"string","enum":["wgs2jgd","jgd2wgs"]}}],"responses":{"200":{"description":"Converted coordinates","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"lat":{"type":"number","example":35.68944,"description":"Converted latitude"},"lng":{"type":"number","example":139.69167,"description":"Converted longitude"},"from":{"type":"string","enum":["WGS84","JGD2011"],"example":"WGS84","description":"Source coordinate system"},"to":{"type":"string","enum":["WGS84","JGD2011"],"example":"JGD2011","description":"Target coordinate system"},"note":{"type":"string","description":"Advisory note about conversion accuracy"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/mynumber/validate":{"get":{"operationId":"mynumberValidate","summary":"Validate Individual Number (マイナンバー) format and Verhoeff check digit","description":"[🆔 Identity & Validation] Validate マイナンバー (Individual Number) format and Verhoeff check digit. Number is NOT stored or returned. Use when: My Number card integration, government benefit applications, Japanese KYC compliance. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"12-digit Individual Number (not stored or returned)","schema":{"type":"string","example":"123456789012"}}],"responses":{"200":{"description":"Validation result (number NOT in response)","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"error":{"type":"string","nullable":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/passport/validate":{"get":{"operationId":"passportValidate","summary":"Validate Japanese passport number format","description":"[🆔 Identity & Validation] Validate Japanese passport number format. Use when: travel booking identity verification, immigration document processing, KYC for Japan-based financial services. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"Passport number to validate","schema":{"type":"string","example":"TK1234567"}}],"responses":{"200":{"description":"Passport validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"normalized":{"type":"string","nullable":true,"description":"Uppercased passport number"},"formatDescription":{"type":"string","nullable":true,"description":"Format description (e.g. \"2 letters + 7 digits\")"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/insurance/validate":{"get":{"operationId":"insuranceValidate","summary":"Validate Japanese social insurance number format (number NOT in response)","description":"[🆔 Identity & Validation] Validate Japanese social insurance number format. Number is NOT returned in response. Use when: employee enrollment for health/pension insurance, HR system data validation, Japanese social security compliance. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"Social insurance number to validate (not returned in response)","schema":{"type":"string","example":"12345678901"}}],"responses":{"200":{"description":"Validation result (number NOT in response)","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"type":{"type":"string","enum":["health","pension"],"description":"Insurance type"},"typeEn":{"type":"string","description":"Insurance type in English"},"digitCount":{"type":"integer","description":"Expected digit count"},"descriptionEn":{"type":"string","description":"Format description in English"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/barcode/validate":{"get":{"operationId":"barcodeValidate","summary":"Validate JAN barcode (EAN-13) or ISBN-13 check digit","description":"[🆔 Identity & Validation] Validate JAN barcode (EAN-13) or ISBN-13 check digit. Use when: Japanese e-commerce product catalog validation, inventory management, publishing/book retail systems. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"code","in":"query","required":true,"description":"Barcode or ISBN to validate","schema":{"type":"string","example":"4901234567890"}}],"responses":{"200":{"description":"Barcode validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"type":{"type":"string","enum":["jan","isbn13","unknown"],"description":"Detected barcode type"},"code":{"type":"string","description":"Cleaned barcode (hyphens removed)"},"checkDigitValid":{"type":"boolean","description":"Whether check digit is valid"},"formatEn":{"type":"string","description":"Format description (e.g. \"JAN-13 (EAN-13)\")"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/plate/validate":{"get":{"operationId":"plateValidate","summary":"Validate Japanese vehicle license plate or VIN","description":"[🆔 Identity & Validation] Validate Japanese vehicle license plate or VIN format. Use when: vehicle registration verification, mobility/car-sharing platform onboarding, fleet management systems. Price: $0.02 USDC per call.","tags":["Identity & Validation"],"security":[{"x402":[]}],"parameters":[{"name":"plate","in":"query","required":true,"description":"License plate or VIN to validate","schema":{"type":"string","example":"品川 300 あ 1234"}}],"responses":{"200":{"description":"Plate or VIN validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"type":{"type":"string","enum":["plate","vin"],"description":"Input type detected"},"typeEn":{"type":"string","description":"Type description in English"},"region":{"type":"string","nullable":true,"description":"License plate region (運輸支局名) — plate type only"},"classNumber":{"type":"string","nullable":true,"description":"3-digit class number — plate type only"},"vehicleCategoryEn":{"type":"string","nullable":true,"description":"Vehicle category in English — plate type only"},"kana":{"type":"string","nullable":true,"description":"Hiragana character — plate type only"},"serialNumber":{"type":"string","nullable":true,"description":"Serial number — plate type only"},"descriptionEn":{"type":"string","description":"Format description in English"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/industry/lookup":{"get":{"operationId":"industryLookup","summary":"Look up industry classification by JSIC Rev.14 code","description":"[🏢 Corporate & KYC] Look up industry classification by JSIC Rev.14 code. Use when: corporate risk scoring, B2B sales segmentation, regulatory reporting by industry sector. Price: $0.02 USDC per call.","tags":["Corporate & KYC"],"security":[{"x402":[]}],"parameters":[{"name":"code","in":"query","required":true,"description":"JSIC Rev.14 industry classification code","schema":{"type":"string","example":"5811"}}],"responses":{"200":{"description":"Industry classification details","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"code":{"type":"string","example":"5811","description":"JSIC Rev.14 code"},"name":{"type":"string","example":"食料品製造業","description":"Industry name in Japanese"},"nameEn":{"type":"string","example":"Food manufacturing","description":"Industry name in English"},"level":{"type":"string","enum":["major","medium","minor"],"description":"Classification level"},"parent":{"type":"string","nullable":true,"description":"Parent industry code (null for top-level)"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/kanji/normalize":{"get":{"operationId":"kanjiNormalizeGet","summary":"Normalize variant/non-standard kanji to standard forms (GET, query params)","description":"[📝 Text & Names] Normalize kanji via GET with query parameters. Convenient for curl / AI agents. direction=old-to-new converts 旧字体→新字体; direction=new-to-old converts 新字体→旧字体. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"text","in":"query","required":true,"schema":{"type":"string"},"description":"Text to normalize (max 5000 chars)","example":"野村証券"},{"name":"direction","in":"query","required":false,"schema":{"type":"string","enum":["old-to-new","new-to-old"],"default":"old-to-new"},"description":"Conversion direction: old-to-new (旧字体→新字体) or new-to-old (新字体→旧字体)","example":"new-to-old"}],"responses":{"200":{"description":"Kanji normalization result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"original":{"type":"string"},"normalized":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"position":{"type":"number","description":"Character position in original text"},"from":{"type":"string","description":"Original character(s)"},"to":{"type":"string","description":"Normalized character(s)"},"type":{"type":"string","description":"Change type (ivs_removed, cjk_normalized, kyujitai, shinjitai)"},"typeEn":{"type":"string","description":"Change type description in English"}}}},"changeCount":{"type":"number","description":"Total number of changes made"},"descriptionEn":{"type":"string","description":"Description of normalization in English"},"note":{"type":"string","description":"Advisory note about the conversion"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}},"post":{"operationId":"kanjiNormalize","summary":"Normalize variant/non-standard kanji to standard forms (IVS removal, 旧字体→新字体)","description":"[📝 Text & Names] Normalize variant/non-standard kanji to standard forms (IVS removal, 旧字体→新字体). Use when: name deduplication in Japanese databases, legal document processing, government system data import. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","example":"渡邊","description":"Text containing variant kanji to normalize (max 5000 chars)"},"direction":{"type":"string","enum":["old-to-new","new-to-old"],"default":"old-to-new","description":"Conversion direction: old-to-new (旧字体→新字体, default) or new-to-old (新字体→旧字体, e.g. 野村証券→野村證券)"},"options":{"type":"object","description":"Normalization options","properties":{"removeIvs":{"type":"boolean","default":true,"description":"Remove IVS (Ideographic Variation Sequences)"},"normalizeCjk":{"type":"boolean","default":true,"description":"Normalize CJK compatibility characters"},"kyujitaiToShinjitai":{"type":"boolean","default":false,"description":"Convert 旧字体 to 新字体 (Joyo 2010)"}}}}}}}},"responses":{"200":{"description":"Kanji normalization result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"original":{"type":"string"},"normalized":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}}}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/eltax/check":{"post":{"operationId":"eltaxCheck","summary":"Electronic bookkeeping (電子帳簿保存法) compliance checklist","description":"[⚖️ Legal & Tax] Get 電子帳簿保存法 (Electronic Bookkeeping Act) compliance checklist for a given document type. Use when: SaaS accounting software Japan compliance, document management systems, auditor checklist generation. Price: $0.02 USDC per call.","tags":["Legal & Tax"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documentType":{"type":"string","description":"Document type for 電子帳簿保存法 compliance check","example":"invoice"}}}}}},"responses":{"200":{"description":"Compliance checklist","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"overallResult":{"type":"string","enum":["pass","fail"],"description":"Overall compliance result"},"complianceStatus":{"type":"string","description":"Human-readable compliance status"},"checks":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"itemEn":{"type":"string"},"result":{"type":"string","enum":["pass","fail"]},"required":{"type":"boolean"},"message":{"type":"string"}}},"description":"Individual compliance check results"},"applicableLaw":{"type":"string","description":"Applicable law reference"},"note":{"type":"string","description":"Japanese advisory note"},"noteEn":{"type":"string","description":"English advisory note"},"referenceDate":{"type":"string","format":"date","description":"Date this checklist is based on"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/kana/convert":{"get":{"operationId":"kanaConvert","summary":"Convert between hiragana, katakana, and half-width katakana","description":"[📝 Text & Names] Convert between hiragana, katakana, and half-width katakana. Use when: legacy system data migration (half-kana normalization), search index unification, Japanese form input normalization. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"text","in":"query","required":true,"description":"Text to convert","schema":{"type":"string","example":"アイウエオ"}},{"name":"to","in":"query","required":true,"description":"Target kana format","schema":{"type":"string","enum":["katakana","hiragana","half-katakana"]}}],"responses":{"200":{"description":"Kana conversion result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"original":{"type":"string"},"converted":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/text/normalize":{"get":{"operationId":"textNormalize","summary":"Normalize full-width/half-width characters (NFKC, ASCII width conversion)","description":"[📝 Text & Names] Normalize full-width/half-width characters (NFKC, ASCII width conversion). Use when: Japanese user-generated content normalization, search index preprocessing, CSV/data import cleansing. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"text","in":"query","required":true,"description":"Text to normalize","schema":{"type":"string","example":"Ａｂｃ１２３"}},{"name":"mode","in":"query","required":true,"description":"Normalization mode","schema":{"type":"string","enum":["nfkc","ascii-narrow","ascii-wide"]}}],"responses":{"200":{"description":"Text normalization result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"original":{"type":"string"},"normalized":{"type":"string"},"mode":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/name/split":{"get":{"operationId":"nameSplit","summary":"Split Japanese full name into family and given name","description":"[📝 Text & Names] Split a Japanese full name into family and given name components. Use when: CRM contact normalization, Japanese HR system import, name field migration from single to dual column. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"name","in":"query","required":true,"description":"Full Japanese name to split","schema":{"type":"string","example":"山田太郎"}}],"responses":{"200":{"description":"Name split result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"original":{"type":"string"},"family":{"type":"string","example":"山田"},"given":{"type":"string","example":"太郎"},"confidence":{"type":"number","example":0.95},"method":{"type":"string","enum":["space","dictionary","positional"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/name/validate":{"get":{"operationId":"nameValidate","summary":"Validate Japanese name against approved kanji list (人名用漢字)","description":"[📝 Text & Names] Validate a Japanese name against the approved kanji list (人名用漢字). Use when: birth registration system validation, legal document name input, Japanese namecard printing verification. Price: $0.02 USDC per call.","tags":["Text & Names"],"security":[{"x402":[]}],"parameters":[{"name":"name","in":"query","required":true,"description":"Japanese name to validate","schema":{"type":"string","example":"山田太郎"}},{"name":"type","in":"query","required":false,"description":"Validation scope: full name, sei (surname) only, or mei (given name) only","schema":{"type":"string","enum":["full","sei","mei"],"default":"full"}}],"responses":{"200":{"description":"Name validation result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"valid":{"type":"boolean"},"invalidChars":{"type":"array","items":{"type":"string"},"description":"Array of non-approved kanji characters found in the name"},"descriptionEn":{"type":"string","description":"Validation result summary in English"},"typeDescriptionEn":{"type":"string","description":"Description of the validation scope (full/sei/mei) in English"},"meta":{"type":"object","description":"Additional metadata about the validation","additionalProperties":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/geo/geocode":{"get":{"operationId":"geoGeocode","summary":"Geocode Japanese address to lat/lng (国土地理院)","description":"[🗺️ Geo & Address] Convert a Japanese address string to latitude/longitude using the GSI (国土地理院) AddressSearch API. Source: 国土地理院 (PDL 1.0). Use when: store locator mapping, delivery route optimization, Japanese property geocoding. Price: $0.02 USDC per call.","tags":["Geo & Address"],"security":[{"x402":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Japanese address string to geocode","schema":{"type":"string","example":"東京駅"}}],"responses":{"200":{"description":"Geocode result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"lat":{"type":"number","example":35.6812},"lng":{"type":"number","example":139.7671},"title":{"type":"string","example":"東京駅"},"addressCode":{"type":"string","example":"13101"},"alternatives":{"type":"array","nullable":true,"description":"Additional candidate results (if any)","items":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"},"title":{"type":"string"},"addressCode":{"type":"string"}}}},"source":{"type":"string","example":"gsi-japan"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"404":{"description":"No results found for the given address","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/geo/reverse-geocode":{"get":{"operationId":"geoReverseGeocode","summary":"Reverse geocode lat/lng to municipality + town name (国土地理院)","description":"[🗺️ Geo & Address] Convert latitude/longitude to Japanese municipality code (JIS X 0402) and town name using the GSI (国土地理院) reverse-geocoder API. Source: 国土地理院 (PDL 1.0). Use when: GPS-based location labeling, field survey data annotation, IoT device location classification. Price: $0.02 USDC per call.","tags":["Geo & Address"],"security":[{"x402":[]}],"parameters":[{"name":"lon","in":"query","required":true,"description":"Longitude (WGS84, decimal degrees)","schema":{"type":"number","example":139.7671}},{"name":"lat","in":"query","required":true,"description":"Latitude (WGS84, decimal degrees)","schema":{"type":"number","example":35.6812}}],"responses":{"200":{"description":"Reverse geocode result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"muniCode":{"type":"string","description":"JIS X 0402 municipality code","example":"13101"},"town":{"type":"string","description":"Town/district name (大字町名)","example":"丸の内"},"source":{"type":"string","example":"gsi-japan"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"404":{"description":"No address found for the given coordinates","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/law/search":{"get":{"operationId":"lawSearch","summary":"Search Japanese laws by title via e-Gov Law API v2","description":"[⚖️ Legal & Tax] Search Japanese laws and regulations by title using the e-Gov Law API v2 (政府標準利用規約, no API key required). Use when: legal research automation, regulatory compliance checking, contract review AI pipelines. Price: $0.02 USDC per call.","tags":["Legal & Tax"],"security":[{"x402":[]}],"parameters":[{"name":"title","in":"query","required":true,"description":"Law title to search (partial match)","schema":{"type":"string","example":"民法"}},{"name":"limit","in":"query","required":false,"description":"Number of results to return (1–50, default: 10)","schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"example":10}}],"responses":{"200":{"description":"Law search results","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of matching laws","example":3},"count":{"type":"integer","description":"Number of results returned","example":3},"laws":{"type":"array","items":{"type":"object","properties":{"lawId":{"type":"string","example":"129AC0000000089"},"lawNumber":{"type":"string","example":"明治二十九年法律第八十九号"},"title":{"type":"string","example":"民法"},"titleKana":{"type":"string","example":"みんぽう"},"abbrev":{"type":"string","nullable":true,"example":null},"category":{"type":"string","nullable":true,"example":"民事"},"promulgationDate":{"type":"string","nullable":true,"example":"18960427"},"updated":{"type":"string","nullable":true,"example":"20240101"}}}},"source":{"type":"string","example":"egov-hourei-api"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/whoami":{"get":{"operationId":"whoami","tags":["Diagnostics"],"summary":"Self IP / country / region","description":"[🛠️ Diagnostics] Returns the calling agent's IP address, country code, city, region, ASN, and User-Agent. Free — no payment or API key required. Use when: debugging connectivity, geo-targeting Japanese vs international users, verifying x402 facilitator routing. Price: FREE.","security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"ip":{"type":"string","example":"203.0.113.42","description":"Client IP address (CF-Connecting-IP)"},"country":{"type":"string","nullable":true,"example":"JP","description":"ISO 3166-1 alpha-2 country code (CF-IPCountry)"},"city":{"type":"string","nullable":true,"example":"Tokyo","description":"City name (CF-IPCity)"},"region":{"type":"string","nullable":true,"example":"Tokyo","description":"Region name (CF-Region)"},"asn":{"type":"string","nullable":true,"example":"13335","description":"Autonomous System Number (CF-ASN)"},"userAgent":{"type":"string","nullable":true,"example":"Mozilla/5.0","description":"User-Agent header"},"ts":{"type":"string","format":"date-time","example":"2026-05-13T00:00:00.000Z","description":"Server timestamp"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}}}}},"/v1/wareki/convert/bulk":{"post":{"operationId":"warekiConvertBulk","summary":"Bulk Japanese era ↔ Gregorian conversion","description":"Bulk variant. Free, no authentication required. Up to 100 items per request. Converts an array of Gregorian dates (YYYY-MM-DD) to wareki in a single call.","tags":["Calendar & Dates"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["dates"],"properties":{"dates":{"type":"array","maxItems":100,"items":{"type":"string","format":"date","example":"2019-05-01"},"description":"Array of Gregorian dates in YYYY-MM-DD format"}}}}}},"responses":{"200":{"description":"Bulk conversion results","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","properties":{"input":{"type":"string","example":"2019-05-01"},"ok":{"type":"boolean"},"era":{"type":"string","example":"令和","nullable":true},"eraRomaji":{"type":"string","example":"Reiwa","nullable":true},"eraYear":{"type":"integer","example":1,"nullable":true},"eraYearLabel":{"type":"string","example":"元年","nullable":true},"formatted":{"type":"string","example":"令和元年5月1日","nullable":true},"error":{"type":"string","nullable":true}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}}}},"/v1/invoice/validate/bulk":{"post":{"operationId":"invoiceValidateBulk","summary":"Bulk invoice number format validation","description":"[⚖️ Legal & Tax] Bulk format validation of Japanese invoice registration numbers (T + 13 digits). Up to 100 items per request. Requires Trial key (1 call/month free) or x402 payment ($0.50 USDC/req). NTA terms of use prohibit mass data collection — authentication prevents automated abuse.","tags":["Legal & Tax"],"security":[{"trialKey":[]},{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["numbers"],"properties":{"numbers":{"type":"array","maxItems":100,"items":{"type":"string","example":"T7000012050002"},"description":"Array of invoice numbers to validate"}}}}}},"responses":{"200":{"description":"Bulk validation results","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","properties":{"input":{"type":"string","example":"T7000012050002"},"ok":{"type":"boolean"},"valid":{"type":"boolean","nullable":true},"format":{"type":"string","enum":["valid","invalid_prefix","invalid_length","invalid_chars"],"nullable":true},"checkDigit":{"type":"object","nullable":true,"properties":{"expected":{"type":"integer"},"actual":{"type":"integer"},"match":{"type":"boolean"}}},"type":{"type":"string","enum":["corporate","individual_or_other"],"nullable":true},"error":{"type":"string","nullable":true}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]}}},"/v1/invoice/verify/bulk":{"post":{"operationId":"invoiceVerifyBulk","summary":"Bulk invoice T-number existence verification (NTA)","description":"[⚖️ Legal & Tax] Bulk verify Japanese qualified invoice issuer T-numbers against NTA registry (適格請求書公表サイト Web-API). Up to 300 numbers per request. Deduplicates input and returns per-item registration status, registrant name/address (with English translation), and cancel date. KV-cached 24 h. Requires x402 payment ($0.50 USDC/req).","tags":["Legal & Tax"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["numbers"],"properties":{"numbers":{"type":"array","maxItems":300,"items":{"type":"string","example":"T1180301018771"},"description":"Array of T-numbers to verify (max 300)"}}}}}},"responses":{"200":{"description":"Bulk verification results","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"total":{"type":"integer","example":2},"results":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","example":"T1180301018771"},"registered":{"type":"boolean"},"confidence":{"type":"number","example":0.99},"verified_at":{"type":"string","format":"date-time"},"registrantName":{"type":"string","nullable":true},"registrantNameEn":{"type":"string","nullable":true},"registrantAddress":{"type":"string","nullable":true},"registrantAddressEn":{"type":"string","nullable":true},"registrationDate":{"type":"string","nullable":true},"cancelDate":{"type":"string","nullable":true},"source":{"type":"string","enum":["nta-invoice-kohyo","mock","cache"]},"error":{"type":"string","nullable":true}}}},"summary":{"type":"object","properties":{"registered_count":{"type":"integer"},"unregistered_count":{"type":"integer"},"invalid_count":{"type":"integer"}}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.50"},"protocols":[{"x402":{}}]}}},"/v1/tax/calculate/bulk":{"post":{"operationId":"taxCalculateBulk","summary":"Bulk Japanese consumption tax calculation","description":"[⚖️ Legal & Tax] Bulk calculate Japanese consumption tax for up to 1000 items per request. Each item specifies amount, rate (8 or 10), and type (exclusive=税抜 / inclusive=税込). Returns per-item tax, totalWithTax, amountExcludingTax and an aggregate summary with by_rate breakdown. Requires x402 payment ($0.10 USDC/req).","tags":["Legal & Tax"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","maxItems":1000,"items":{"type":"object","required":["amount","rate","type"],"properties":{"amount":{"type":"number","example":1000,"description":"Price amount (non-negative)"},"rate":{"type":"integer","enum":[8,10],"description":"Tax rate: 8% (reduced) or 10% (standard)"},"type":{"type":"string","enum":["exclusive","inclusive"],"description":"exclusive=税抜価格, inclusive=税込価格"}}},"description":"Array of items to calculate tax for (max 1000)"}}}}}},"responses":{"200":{"description":"Bulk tax calculation results","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"total":{"type":"integer","example":3},"results":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"rate":{"type":"integer","enum":[8,10]},"type":{"type":"string","enum":["exclusive","inclusive"]},"tax":{"type":"number"},"totalWithTax":{"type":"number"},"amountExcludingTax":{"type":"number"}}}},"summary":{"type":"object","properties":{"totalAmount":{"type":"number"},"totalTax":{"type":"number"},"totalWithTax":{"type":"number"},"totalExcludingTax":{"type":"number"},"by_rate":{"type":"object","description":"Subtotals keyed by tax rate (e.g. \"8\", \"10\")","additionalProperties":{"type":"object","properties":{"count":{"type":"integer"},"totalAmount":{"type":"number"},"totalTax":{"type":"number"}}}}}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]}}},"/v1/company/full-profile":{"get":{"operationId":"companyFullProfile","summary":"Corporate number → company info + invoice status (composite)","description":"[🏢 Corporate & KYC] One-call composite endpoint: 13-digit corporate number → company name, address, kind, status (from NTA 法人番号 API) plus optional invoice registration check (from NTA 適格請求書 API). Use when: B2B onboarding, KYC, accounts-payable validation in a single API call. Price: $0.05 USDC per call. Note: government agencies (e.g. NTA itself) are often not registered as qualified invoice issuers — registered:false is correct for them.","tags":["Corporate & KYC"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"13-digit Japanese corporate number (法人番号). Example: 7000012050002","schema":{"type":"string","pattern":"^\\d{13}$","example":"7000012050002"}},{"name":"verify_invoice","in":"query","required":false,"description":"If true, also verify the corresponding T-number (T + corporate number) against NTA invoice registry. Default: false.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Company full profile","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"houjinBangou":{"type":"string","example":"7000012050002"},"name":{"type":"string","example":"国税庁"},"nameKana":{"type":"string","nullable":true},"nameEn":{"type":"string","nullable":true},"kind":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"ja":{"type":"string"},"en":{"type":"string"}}},"address":{"type":"object","properties":{"full":{"type":"string","example":"東京都千代田区霞が関３丁目１－１"},"prefecture":{"type":"string","nullable":true},"prefectureEn":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"postalCode":{"type":"string","nullable":true}}},"status":{"type":"string","enum":["active","closed","merged","unknown"]},"invoiceStatus":{"type":"object","nullable":true,"description":"Present only when verify_invoice=true","properties":{"registered":{"type":"boolean"},"registrantName":{"type":"string","nullable":true},"registrationDate":{"type":"string","nullable":true},"cancelDate":{"type":"string","nullable":true}}},"confidence":{"type":"number","example":0.99},"verified_at":{"type":"string","format":"date-time"},"sources":{"type":"array","items":{"type":"string"},"example":["nta-houjin-bangou"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid or missing number","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"404":{"description":"Company not found","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/v1/invoice/company-profile":{"get":{"operationId":"invoiceCompanyProfile","summary":"T-number → invoice status + company details (composite)","description":"[⚖️ Legal & Tax] One-call composite endpoint: T-number (T + 13-digit) → invoice registration status (from NTA 適格請求書 API) plus corporate details (from NTA 法人番号 API). Use when: invoice processing AI agents need to validate a T-number and get company details in one step. Price: $0.05 USDC per call. Note: government agencies may return registered:false — this is expected behavior per Japanese tax law.","tags":["Legal & Tax"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"Invoice T-number (T + 13 digits). Example: T1180301018771","schema":{"type":"string","pattern":"^T\\d{13}$","example":"T1180301018771"}}],"responses":{"200":{"description":"Invoice + company profile","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"invoiceNumber":{"type":"string","example":"T1180301018771"},"registered":{"type":"boolean","example":true},"confidence":{"type":"number","example":0.99},"registrantName":{"type":"string","nullable":true},"registrantNameEn":{"type":"string","nullable":true},"registrantAddress":{"type":"string","nullable":true},"registrantAddressEn":{"type":"string","nullable":true},"registrationDate":{"type":"string","nullable":true},"cancelDate":{"type":"string","nullable":true},"houjin":{"type":"object","nullable":true,"description":"Present when registered=true and corporate details are available","properties":{"houjinBangou":{"type":"string"},"name":{"type":"string"},"nameKana":{"type":"string","nullable":true},"kind":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"ja":{"type":"string"},"en":{"type":"string"}}},"address":{"type":"object","properties":{"full":{"type":"string"},"prefecture":{"type":"string","nullable":true},"prefectureEn":{"type":"string","nullable":true},"postalCode":{"type":"string","nullable":true}}},"status":{"type":"string","enum":["active","closed","merged","unknown"]}}},"sources":{"type":"array","items":{"type":"string"},"example":["nta-invoice-kohyo","nta-houjin-bangou"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid or missing number","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}},"502":{"description":"Upstream NTA API error","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/v1/freelance/order/validate":{"post":{"operationId":"freelanceOrderValidate","summary":"Validate freelance order document compliance (フリーランス新法)","description":"[⚖️ Legal & Tax] Validate a freelance order document against フリーランス新法 (Freelance Protection Act, effective 2024-11-01) mandatory disclosure requirements (7 items). Use when: freelance contract management platforms, accounts-payable automation, compliance audit pipelines for Japan B2B. Price: $0.02 USDC per call.","tags":["Legal & Tax"],"security":[{"x402":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["order"],"properties":{"order":{"type":"object","description":"Freelance order document fields to validate","properties":{"description":{"type":"string","description":"① 給付の内容（業務内容）. Example: \"Webサイトデザイン制作\"","example":"Webサイトデザイン制作"},"amount":{"type":"number","description":"② 報酬の額（数値・0以上）. Example: 300000","example":300000},"currency":{"type":"string","description":"通貨コード（省略時またはJPY推奨）. Example: \"JPY\"","example":"JPY"},"paymentDueDays":{"type":"integer","description":"③ 支払期日（受領日からの日数・60日以内必須）. Example: 30","example":30},"deliveryDate":{"type":"string","format":"date","description":"④ 給付を受領する日（納品日・YYYY-MM-DD形式）. Example: \"2026-06-30\"","example":"2026-06-30"},"deliveryLocation":{"type":"string","description":"⑤ 給付を受領する場所. Example: \"東京都渋谷区オンライン納品\"","example":"東京都渋谷区オンライン納品"},"inspectionDate":{"type":"string","format":"date","description":"⑥ 検査（検収）完了期日（YYYY-MM-DD形式・7日以内推奨）. Example: \"2026-07-07\"","example":"2026-07-07"},"paymentMethod":{"type":"string","description":"⑦ 報酬の支払方法. Example: \"銀行振込\"","example":"銀行振込"},"client":{"type":"object","description":"発注者情報","properties":{"name":{"type":"string","description":"発注者名（必須）","example":"株式会社サンプル"},"address":{"type":"string","description":"発注者住所（任意）","example":"東京都千代田区..."}}},"contractor":{"type":"object","description":"受託者情報","properties":{"name":{"type":"string","description":"受託者名（必須）","example":"山田太郎"},"address":{"type":"string","description":"受託者住所（任意）","example":"東京都渋谷区..."}}}}}}}}}},"responses":{"200":{"description":"Compliance check result","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"compliant":{"type":"boolean","description":"true if no violations and no missing required fields","example":false},"checks":{"type":"array","description":"Per-item check results for all 7 mandatory fields plus party info","items":{"type":"object","properties":{"item":{"type":"string","example":"paymentDueDays"},"status":{"type":"string","enum":["ok","warning","violation","missing"],"example":"violation"},"note":{"type":"string","nullable":true,"example":"支払期日は受領日から 60 日以内が必要です（フリーランス新法第5条）"}}}},"violations":{"type":"array","description":"Field names that violate a legal requirement","items":{"type":"string"},"example":["paymentDueDays"]},"warnings":{"type":"array","description":"Field names with advisory warnings (not violations)","items":{"type":"string"},"example":["inspectionDate"]},"missing":{"type":"array","description":"Required field names that are absent from the order","items":{"type":"string"},"example":["description"]},"summary":{"type":"string","enum":["compliant","compliant with warnings","non-compliant"],"description":"Overall compliance summary","example":"non-compliant"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}},"headers":{"X-Trial-Remaining":{"description":"Remaining trial calls this month (only when X-Trial-Key auth was used)","schema":{"type":"integer","example":95}},"X-Trial-Reset":{"description":"ISO 8601 timestamp when trial counter resets (only when X-Trial-Key auth was used)","schema":{"type":"string","format":"date-time","example":"2026-06-01T00:00:00.000Z"}}}},"400":{"description":"Invalid request body or missing order object","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"402":{"description":"Payment required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string","example":"Payment required"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"base"},"maxAmountRequired":{"type":"string","example":"0.001"},"resource":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"},"payTo":{"type":"string","example":"0x..."},"maxTimeoutSeconds":{"type":"integer","example":30},"asset":{"type":"string","example":"USDC"}}}}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]}}},"/v1/trial/signup":{"post":{"operationId":"trialSignup","summary":"Register a free trial key (100 calls/month)","description":"Sign up with your email to receive a free trial key. The key grants 100 API calls per month across all endpoints. Resets on the 1st of each calendar month. No credit card or crypto wallet required. Rate limit: 1 signup per IP per 24 hours.","tags":["Diagnostics"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","consent"],"properties":{"email":{"type":"string","format":"email","description":"Your email address","example":"developer@example.com"},"consent":{"type":"boolean","const":true,"description":"Must be true. Indicates consent to Terms of Service and Privacy Policy.","example":true},"optInMarketing":{"type":"boolean","description":"Optional. Subscribe to product updates and usage tips.","example":false}}}}}},"responses":{"200":{"description":"Trial key issued","content":{"application/json":{"schema":{"type":"object","required":["ok","data"],"properties":{"ok":{"type":"boolean","enum":[true]},"data":{"type":"object","properties":{"trialKey":{"type":"string","example":"trial_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4","description":"Include as X-Trial-Key header on API requests"},"email":{"type":"string","example":"developer@example.com"},"monthlyLimit":{"type":"integer","example":100},"message":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"400":{"description":"Invalid email or missing field","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}},"429":{"description":"Rate limit exceeded (1 signup per IP per 24h)","content":{"application/json":{"schema":{"type":"object","required":["ok","error"],"properties":{"ok":{"type":"boolean","enum":[false]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"MISSING_PARAM"},"message":{"type":"string"}}}}}}}}}}}}}