{"uid":"cap__LW5WlfAgxGlqrNAXCHUk","slug":"chappy-japan-address-preflight-8c3c2507","name":"CHAPPY Japan Address Preflight","description":"Town-level Japan Post evidence for buyer agents. Returns MATCHED, AMBIGUOUS, CONFLICT, or NOT_FOUND with ordered candidates, provenance, limitations, and the next safe input action.","url":"https://chappy-japan-address-preflight.pre23964wb.workers.dev/v1/jp/address/preflight","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"use_case":{"enum":["delivery","visit","vendor_onboarding","form_submission"],"type":"string"},"postal_code":{"type":"string","description":"Japanese seven-digit postal code; full-width digits and common hyphens are accepted"},"raw_address":{"type":"string","maxLength":512,"minLength":2,"description":"Japanese address text to compare at the town level"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pUU8nb1p-Dt2VV4C34KwI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a Japanese address at the town level against Japan Post data, returning a match status (MATCHED, AMBIGUOUS, CONFLICT, or NOT_FOUND) with ordered candidates and safe next-action guidance.","exampleAgentPrompt":"Before we ship this order to 〒150-0001 Tokyo, Shibuya-ku, Jingumae 1-chome, can you do a delivery preflight check on that Japanese address to make sure the postal code and town actually match?","exampleUseCases":[{"title":"E-commerce delivery address check","prompt":"We have a customer order shipping to 〒100-0001 with address '東京都千代田区千代田1' — run a delivery preflight on it so we can confirm the postal code and town match before we hand it off to the carrier."},{"title":"Vendor onboarding address verification","prompt":"We're onboarding a new Japanese supplier who listed their address as 〒530-0001 大阪市北区梅田1丁目 — can you do a vendor_onboarding preflight check to confirm that address is real and flag any conflicts?"},{"title":"Web form submission address validation","prompt":"A user just submitted a Japanese address in our form: postal code 2310023, address '神奈川県横浜市中区山下町1' — run a form_submission preflight so we know if it's matched, ambiguous, or not found before we save it."}],"resultDescription":"Returns a status of MATCHED, AMBIGUOUS, CONFLICT, or NOT_FOUND along with an ordered list of candidate addresses sourced from Japan Post evidence, provenance details, any known limitations, and a recommended next safe input action for the calling agent to take.","failureModes":["NOT_FOUND returned when postal code or address text does not correspond to any Japan Post record","AMBIGUOUS returned when multiple town-level candidates exist and cannot be resolved from the input alone","CONFLICT returned when the postal code and address text disagree at the town level","Malformed postal code (wrong digit count or unsupported characters) may result in a validation error","raw_address below minimum length or exceeding 512 characters will be rejected","Missing required fields (postal_code or raw_address) return a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need town-level Japan Post evidence for a Japanese address before committing to a delivery, payment, form save, or vendor record — especially when you need a structured status (MATCHED/AMBIGUOUS/CONFLICT/NOT_FOUND) plus actionable next-step guidance rather than a simple boolean. It is particularly suited for agentic workflows that need provenance and candidate lists to handle ambiguity gracefully. Prefer it over generic geocoding APIs when Japan-specific postal data fidelity and use-case-aware recommendations are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:11.692Z","isFirstParty":false}