{"uid":"cap_TA7fsOI7oUguzDDzysvjr","slug":"suverse-international-postal-code-lookup-3ef662a3","name":"Suverse International Postal Code Lookup","description":"Look up any postal code worldwide by 2-letter country code. Returns place name, state/region, latitude, and longitude. Covers Germany, UK, Canada, Netherlands, Spain and dozens more countries. Free Zippopotam.us data.","url":"https://proxy.suverse.io/v1/data/suverse-postal-intl-code","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.055","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.055/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.055","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.055","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MihbWXEGU378JwRy-WB4U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.055","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns place name, state/region, latitude, and longitude for any postal code given a 2-letter country code, powered by Zippopotam.us data.","exampleAgentPrompt":"What city and region does the postal code W1A 1AA correspond to in the UK, and what are its coordinates?","exampleUseCases":[{"title":"Validate international shipping address","prompt":"I have a customer order going to postal code 10115 in Germany — can you tell me what city and region that maps to so I can confirm the shipping address is correct?"},{"title":"Geocode postal code for mapping","prompt":"I need the latitude and longitude for postal code M5V in Canada so I can plot it on a map."},{"title":"Enrich e-commerce order data","prompt":"A user entered postal code 28080 with country code ES — look up what place name and region that corresponds to so I can autofill their address form."}],"resultDescription":"Returns the place name (city/town), state or region name, latitude, and longitude associated with the given postal code and country code. May return multiple place entries if the postal code covers more than one locality.","failureModes":["Invalid or non-existent postal code returns an error or empty result","Unsupported country code returns no data","Malformed request body causes a 4xx error","Payment not settled causes a 402 Payment Required response","Temporary upstream Zippopotam.us unavailability causes a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need to resolve international postal codes to geographic data (place name, region, coordinates) across a wide range of countries including Germany, UK, Canada, Netherlands, and Spain without requiring an API key. It is ideal for address enrichment, shipping validation, or geocoding workflows where only a postal code and country code are known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:17.012Z","isFirstParty":false}