{"uid":"cap_3DglFe-ArglIQAWLFAhbg","slug":"saylor-innovations-japan-postcode-lookup-5f95ec3e","name":"Saylor Innovations Japan Postcode Lookup","description":"Japanese address from a seven-digit postal code - prefecture, city and town in Japanese plus kana readings and the prefecture code from Japan Post data","url":"https://saylorinnovations.com/api/japan/postcode/:zip?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["zip"],"properties":{"zip":{"type":"string","description":"Seven-digit postal code in the path, e.g. 1000001 or 100-0001"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["postcode","addresses"],"properties":{"source":{"type":"string","description":"Data source the values come from"},"matches":{"type":"number","description":"Matching items"},"postcode":{"type":"string"},"addresses":{"type":"array"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8rTiM4Vdvg9iKj572Ocye","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the Japanese address components (prefecture, city, town in Japanese and kana) plus the prefecture code for a given 7-digit Japanese postal code, sourced from Japan Post data.","exampleAgentPrompt":"What's the full Japanese address — prefecture, city, and town — for postal code 1600022? I need the names in Japanese characters and the kana readings too.","exampleUseCases":[{"title":"E-commerce address auto-fill","prompt":"I have a Japanese customer who entered postal code 1500001 at checkout — can you look up the matching prefecture, city, and town in Japanese so I can pre-fill the address form for them?"},{"title":"Verifying a Japanese shipping address","prompt":"I need to check if postal code 5430001 corresponds to Osaka city — can you give me the full prefecture, city, and town details from Japan Post data, including kana readings?"},{"title":"Building a Japan address directory","prompt":"For a list of locations in our database, I need the Japanese address breakdown for postal code 0600001 — prefecture, city, ward or town in kanji and kana, and the prefecture code."}],"resultDescription":"A structured response containing the prefecture name in kanji, city name in kanji, town/ward name in kanji, their respective kana readings, and the numeric Japan Post prefecture code — all derived from official Japan Post postal data for the requested 7-digit zip code.","failureModes":["Invalid or malformed postal code (not 7 digits) returns an error","Postal code not found in Japan Post database returns a not-found response","Missing zip path parameter returns a bad request error","Ambiguous postal codes that map to multiple addresses may return only one match or an array"],"whenToPreferThis":"Choose this endpoint when you need to resolve a 7-digit Japanese postal code into structured address components (prefecture, city, town) with both kanji and kana representations and the official prefecture code, sourced from Japan Post data. Prefer this over generic geocoding APIs when you specifically need Japanese address hierarchy in native script rather than romanized or lat/lng output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:21:56.548Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-japan-postcode-lookup-5f95ec3e"}