{"uid":"cap_-rP1mrF67OSXfrsKkPGZh","slug":"worlddata402-postal-code-lookup-9c7f1bb2","name":"WorldData402 Postal Code Lookup","description":"Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).","url":"https://worlddata402.worlddata402.workers.dev/v1/postal/%7Bcountry%7D/%7Bcode%7D?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"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_G58DyVr0Sil02OmM0kR-r","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":"Looks up geographic and administrative data for a given postal code within a specified country","exampleAgentPrompt":"Can you look up the city, region, and geographic details for postal code 10115 in Germany?","exampleUseCases":[{"title":"Address validation for e-commerce checkout","prompt":"A customer entered postal code 75008 for France — can you look up what city and region that belongs to so I can confirm their shipping address makes sense?"},{"title":"Enriching CRM records with location data","prompt":"I have a contact with postal code M5H 2N2 in Canada but no city or province listed — can you pull the location details for that postal code so I can fill in their profile?"},{"title":"Verifying delivery zone coverage","prompt":"We're expanding delivery to Japan — can you check postal code 100-0001 and tell me the city and administrative region it falls under?"}],"resultDescription":"Returns structured geographic and administrative data for the specified postal code, including city name, region or state, country subdivision, and potentially latitude/longitude coordinates and other reference metadata associated with that postal area.","failureModes":["Invalid or non-existent postal code returns an error or empty result","Unsupported country code may return an error or no data","Malformed country or postal code path parameters cause a request error","Payment failure via x402/USDC results in a 402 Payment Required response","Rate limiting or network timeouts on the Cloudflare Worker may produce 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need authoritative postal code-to-location resolution for international addresses across multiple countries, especially within an AI agent workflow that uses x402 micropayments (USDC on Base) for pay-per-call access. Prefer it over free geocoding APIs when you need clean structured reference data without API key management overhead, or when operating in an agentic context already integrated with x402 payment rails.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T18:37:04.470Z","isFirstParty":false,"canonicalSlug":"worlddata402-postal-code-lookup-9c7f1bb2"}