{"uid":"cap_HPGicUUSKJxe4_tzO46BN","slug":"postal-code-lookup-c16b47f7","name":"Postal Code Lookup","description":"Places for a postal or ZIP code in about 60 countries: place names, state or region and coordinates. Use to validate addresses, fill forms or locate customers.","url":"https://bess-x402.onrender.com/v1/geo/postcode?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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["country","code"],"properties":{"code":{"type":"string","description":"Postal code"},"country":{"type":"string","description":"ISO 2-letter country code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e9lzhueX5fktMNeJeGpzH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns place names, state/region, and coordinates for a given postal or ZIP code in about 60 countries.","exampleAgentPrompt":"What city, region, and coordinates are associated with postal code 10115 in Germany?","exampleUseCases":[{"title":"Autofill city from ZIP at checkout","prompt":"A customer just entered ZIP code 90210 in the US on our checkout form — can you fill in the city and state for them automatically?"},{"title":"Validate and locate international customer","prompt":"We have a customer who says they're in Canada with postal code M5H 2N2 — can you confirm what city and region that is and get the coordinates?"},{"title":"Map customer locations by postcode","prompt":"I have a list of UK postcodes and I need to know the place name and coordinates for EC1A 1BB so I can plot it on a map."}],"resultDescription":"Returns one or more places matching the postal code, including place name(s), state or region name, and geographic coordinates (latitude/longitude) for the given country and code combination.","failureModes":["Invalid or unknown postal code returns empty results or error","Unsupported country code returns an error or no data","Malformed ISO country code causes a validation error","Some countries have incomplete postal code coverage, returning partial or no results"],"whenToPreferThis":"Use this endpoint when you need lightweight postal-code-to-location resolution without a full geocoding pipeline — ideal for address validation, form autofill, or customer location enrichment across ~60 countries at very low cost per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:48:29.675Z","isFirstParty":false,"canonicalSlug":"postal-code-lookup-c16b47f7"}