{"openapi":"3.1.0","info":{"title":"Torify API","description":"36 Japanese locale APIs for AI agents: invoice compliance (NTA), corporate number verification (法人番号), address normalization, wareki date conversion, phone normalization, and 31 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) · Glama · 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 ($49/mo). Free endpoints: /health, /openapi.json, /.well-known/x402, /v1/wareki/convert/bulk, /v1/invoice/validate/bulk."},"servers":[{"url":"https://torify.dev","description":"Current server"}],"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."}},"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":"Convert between Japanese wareki (元号) and Gregorian dates. Price: $0.02 USDC per call.","tags":["Japanese Date"],"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}}],"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日"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"400":{"description":"Invalid parameters"},"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":"Validate format of Japanese invoice registration number (T + 13 digits). Does NOT call NTA API. Price: $0.02 USDC per call.","tags":["Invoice"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string","example":"T8010401050783"}}],"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.)"}}}}}},"400":{"description":"Missing parameter"},"402":{"description":"Payment required"}},"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":"Verify registration status of invoice number via NTA public API. Returns registrant name, address, registration date. All responses include the mandatory NTA disclaimer. Price: $0.02 USDC per call.","tags":["Invoice"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"schema":{"type":"string","example":"T8010401050783"}}],"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-api","mock"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"400":{"description":"Invalid format"},"402":{"description":"Payment required"},"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":"Look up company information by 13-digit corporate number using NTA Corporate Number API. Price: $0.02 USDC per call.","tags":["Corporate"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"13-digit corporate number","schema":{"type":"string","example":"8010401050783"}}],"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":"8010401050783"},"name":{"type":"string","example":"NTTドコモ"},"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.)"}}}}}},"400":{"description":"Invalid number format"},"402":{"description":"Payment required"},"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":"Look up address from 7-digit Japanese postal code. Price: $0.02 USDC per call.","tags":["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":"トウキョウト"},"city":{"type":"string","example":"千代田区"},"cityKana":{"type":"string","example":"チヨダク"},"town":{"type":"string","example":"千代田"},"townKana":{"type":"string","example":"チヨダ"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"400":{"description":"Invalid or missing postal code"},"402":{"description":"Payment required"},"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":"Convert Japanese name from kana to modified Hepburn romanization (passport-standard). Input must be kana (hiragana or katakana). Price: $0.02 USDC per call.","tags":["Text"],"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.)"}}}}}},"400":{"description":"Missing or invalid name"},"402":{"description":"Payment required"}},"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":"Convert Japanese text containing kanji to hiragana or katakana using Yahoo! JLP. Text without kanji is passed through unchanged. Price: $0.02 USDC per call.","tags":["Text"],"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":["yahoo-jlp","passthrough","mock"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"400":{"description":"Missing text"},"402":{"description":"Payment required"}},"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":"Calculate Japanese consumption tax. Price: $0.02 USDC per call.","tags":["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"}}],"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},"tax":{"type":"number","example":100},"total":{"type":"number","example":1100},"rate":{"type":"number","example":0.1},"rateLabel":{"type":"string","example":"10%（標準税率）"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Validate and normalize a Japanese phone number. Price: $0.02 USDC per call.","tags":["Phone"],"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":{"input":{"type":"string"},"e164":{"type":"string","example":"+81312345678"},"areaCode":{"type":"string","example":"03"},"type":{"type":"string","enum":["fixed","mobile","toll-free","etc"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Parse and normalize a Japanese address. Price: $0.02 USDC per call.","tags":["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.)"}}}}}},"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":"Check if a date is a Japanese public holiday. Price: $0.02 USDC per call.","tags":["Calendar"],"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}}],"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},"type":{"type":"string","example":"national","nullable":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"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). Useful for payroll, EOR, and shift management systems. Price: $0.02 USDC per call.","tags":["Calendar"],"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.)"}}}}}},"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":"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. Useful for HR systems (academic history input) and EdTech. Price: $0.02 USDC per call.","tags":["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.)"}}}}}},"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":"Calculate Japanese age, school year, and era-based age. Price: $0.02 USDC per call.","tags":["Calendar"],"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"}}],"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"},"asOf":{"type":"string","format":"date"},"age":{"type":"integer","example":34},"eraAge":{"type":"string","example":"令和6年度時点で34歳"},"schoolYear":{"type":"string","example":"大学3年生相当"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Look up bank and branch information by Zengin code. Price: $0.02 USDC per call.","tags":["Finance"],"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":{"code":{"type":"string","example":"0001"},"name":{"type":"string","example":"みずほ銀行"},"nameKana":{"type":"string","example":"ミズホ"},"branchCode":{"type":"string","example":"001","nullable":true},"branchName":{"type":"string","example":"本店","nullable":true},"branchNameKana":{"type":"string","example":"ホンテン","nullable":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"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. Price: $0.02 USDC per call.","tags":["Finance"],"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.)"}}}}}},"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":"Return all Japanese banks (~1,150 institutions including credit unions and JA banks) with code, name, kana, romaji, and branch count. Paginated. Price: $0.02 USDC per call.","tags":["Finance"],"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.)"}}}}}},"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":"Validate bank transfer account details in Zengin format. Price: $0.02 USDC per call.","tags":["Finance"],"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","schema":{"type":"string","enum":["普通","当座","貯蓄"]}},{"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"},"normalized":{"type":"object","additionalProperties":true},"errors":{"type":"array","items":{"type":"string"}}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Convert Japan Post (ゆうちょ) account to standard bank transfer format. Price: $0.02 USDC per call.","tags":["Finance"],"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":{"symbol":{"type":"string"},"number":{"type":"string"},"bankCode":{"type":"string","example":"9900"},"branchCode":{"type":"string","example":"001"},"accountNumber":{"type":"string"},"accountType":{"type":"string","example":"普通"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Check 3D Secure 2.0 requirement for a given MCC and BIN. Price: $0.02 USDC per call.","tags":["Finance"],"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":{"mcc":{"type":"string"},"bin":{"type":"string"},"requires3ds":{"type":"boolean"},"reason":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Look up prefecture or municipality by JIS X 0402 code. Price: $0.02 USDC per call.","tags":["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"},"type":{"type":"string","enum":["prefecture","municipality"]},"prefecture":{"type":"string","example":"東京都"},"municipality":{"type":"string","example":"千代田区","nullable":true},"prefectureCode":{"type":"string","example":"13"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Convert geographic coordinates between WGS84 and JGD2011. Price: $0.02 USDC per call.","tags":["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":{"input":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}}},"output":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}}},"from":{"type":"string","enum":["wgs84","jgd2011"]},"to":{"type":"string","enum":["wgs84","jgd2011"]}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Validate マイナンバー format and Verhoeff check digit. Number is NOT stored or returned. Price: $0.02 USDC per call.","tags":["Identity"],"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.)"}}}}}},"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":"Validate Japanese passport number format. Price: $0.02 USDC per call.","tags":["Identity"],"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},"format":{"type":"string","nullable":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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/license/validate":{"get":{"operationId":"licenseValidate","summary":"Validate Japanese driver's license number format (12 digits)","description":"Validate Japanese driver's license number format. Price: $0.02 USDC per call.","tags":["Identity"],"security":[{"x402":[]}],"parameters":[{"name":"number","in":"query","required":true,"description":"12-digit driver's license number","schema":{"type":"string","example":"123456789012"}}],"responses":{"200":{"description":"License 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}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Validate Japanese social insurance number format. Number is NOT returned in response. Price: $0.02 USDC per call.","tags":["Identity"],"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"},"error":{"type":"string","nullable":true}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Validate JAN barcode or ISBN-13 check digit. Price: $0.02 USDC per call.","tags":["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","ean13"]},"normalized":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Validate Japanese vehicle license plate or VIN format. Price: $0.02 USDC per call.","tags":["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"]},"normalized":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Look up industry classification by JSIC Rev.14 code. Price: $0.02 USDC per call.","tags":["Business"],"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"},"name":{"type":"string","example":"食料品製造業"},"nameEn":{"type":"string","example":"Food manufacturing"},"division":{"type":"string"},"majorGroup":{"type":"string"},"minorGroup":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":{"post":{"operationId":"kanjiNormalize","summary":"Normalize variant/non-standard kanji to standard forms (IVS removal, 旧字体→新字体)","description":"Normalize variant and non-standard kanji to standard forms. Price: $0.02 USDC per call.","tags":["Text"],"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)"},"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.)"}}}}}},"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":"Get 電子帳簿保存法 compliance checklist for a given document type. Price: $0.02 USDC per call.","tags":["Compliance"],"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":{"type":{"type":"string"},"requirements":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"required":{"type":"boolean"},"note":{"type":"string"}}}},"compliant":{"type":"boolean"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":"Convert between hiragana, katakana, and half-width katakana. Price: $0.02 USDC per call.","tags":["Text"],"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.)"}}}}}},"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":"Normalize full-width/half-width characters. Price: $0.02 USDC per call.","tags":["Text"],"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.)"}}}}}},"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":"Split a Japanese full name into family and given name components. Price: $0.02 USDC per call.","tags":["Name"],"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.)"}}}}}},"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":"Validate a Japanese name against the approved kanji list (人名用漢字). Price: $0.02 USDC per call.","tags":["Name"],"security":[{"x402":[]}],"parameters":[{"name":"name","in":"query","required":true,"description":"Japanese name to validate","schema":{"type":"string","example":"山田太郎"}}],"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"},"nameKanji":{"type":"array","items":{"type":"string"},"description":"Array of kanji characters in the name"}}},"meta":{"type":"object","additionalProperties":true,"description":"Optional metadata (source, disclaimer, cache info, etc.)"}}}}}},"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":{}}]}}}}}