{"uid":"cap_xOFBci8lFM7pIcevJPLTG","slug":"japan-postal-lookup-87dc7a2e","name":"Japan Postal Lookup","description":"Japanese postal-code lookup and reverse lookup. Keywords: Japanese postal lookup, Japan Post postal code, postal code reverse lookup, 日本郵便番号検索. Use a postal code or prefecture/city/ward/town components against the local Japan Post snapshot. / 通过邮编或都道府县、市区町村、区、町名字段，在本地 Japan Post 数据中进行日本邮编反查。","url":"https://api.jpverify.com/jp-address/postal-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_W6W7xZfkiLAsf2sY0TQer","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up Japanese addresses by postal code, or finds postal codes by prefecture/city/ward/town components, against a local Japan Post snapshot.","exampleAgentPrompt":"Can you look up the address details for Japanese postal code 150-0001 and return the prefecture, city, ward, and town — up to 5 results?","exampleUseCases":[{"title":"Expand postal code to full address","prompt":"I have the Japanese postal code 530-0001 — can you tell me what prefecture, city, ward, and town it maps to? Give me up to 3 matching results."},{"title":"Reverse lookup postal code by area","prompt":"What's the postal code for Shinjuku ward, Kabukicho in Tokyo? Search by prefecture Tokyo, ward Shinjuku, and town Kabukicho and return up to 10 candidates."},{"title":"Autofill address form from postcode","prompt":"A customer entered postal code 100-6008 on our checkout form — can you fill in the prefecture, city, and ward automatically so they don't have to type it all out?"}],"resultDescription":"Returns a list of matching address candidates (up to max_results, default 10, max 50), each containing postal code, prefecture, city, ward, town, and county components sourced from the local Japan Post snapshot.","failureModes":["Invalid postal code format (must match \\d{3}-?\\d{4}) returns validation error","No matching records found for given postal code or address components returns empty candidate list","Ambiguous or incomplete address components may return too many or too few candidates","max_results out of range (below 1 or above 50) returns validation error","All fields null/missing with no search criteria returns error or empty result"],"whenToPreferThis":"Choose this endpoint when you need to resolve a Japanese postal code to its address components, or find postal codes matching specific geographic components (prefecture, city, ward, town), using an authoritative Japan Post local data snapshot. Prefer it over general geocoding endpoints when the primary key is a postal code or address subdivision rather than a free-text address string. Use Japan Address Normalize or Japan Address Parse siblings when the input is a free-text address string rather than structured components.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:50:04.097Z","isFirstParty":false,"canonicalSlug":"japan-postal-lookup-87dc7a2e"}