{"uid":"cap_PwUuSiICwfAVXrSRwRBNi","slug":"global-postal-code-geocoder-zippopotam-us-9c017875","name":"Global Postal Code Geocoder (Zippopotam.us)","description":"Resolves a postal code in one country (ISO 2-letter code, e.g. US, DE, TR, GB) to its place names, state or province, and latitude and longitude, from Zippopotam.us. Covers only the countries that service publishes. No time zone or administrative municipality is returned, since no free source for them was used.","url":"https://api.fadeandco.workers.dev/api/agent-intel/global-postal-geocode-resolver?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"],"type":"string"},"queryParams":{"type":"object","required":["country","postalCode"],"properties":{"country":{"type":"string","description":"Two-letter ISO country code, e.g. US, DE, TR, GB"},"postalCode":{"type":"string","description":"Postal code as written for that country, 2 to 12 characters"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"places":[{"name":"Beverly Hills","state":"California","latitude":34.0901,"longitude":-118.4065,"stateCode":"CA"}],"source":"https://api.zippopotam.us/us/90210","country":"United States","checkedAt":"2026-10-23T09:35:23.604Z","postalCode":"90210","countryCode":"US"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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_v5FrSmQmfYcn9SHSzSMLF","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":"Resolves a postal code and ISO country code to place names, state/province, and lat/lng coordinates using Zippopotam.us data.","exampleAgentPrompt":"What city and coordinates does postal code 90210 in the US correspond to?","exampleUseCases":[{"title":"E-commerce shipping address enrichment","prompt":"I have a customer order with postal code 10001 in the US — can you look up the city, state, and coordinates for that ZIP so I can validate the shipping region?"},{"title":"European delivery zone mapping","prompt":"We're building a delivery map for Germany. Can you resolve postal code 80331 to its city name, state, and lat/lng so we can plot it on a map?"},{"title":"User profile location enrichment","prompt":"A user signed up with postal code TR-34000 in Turkey — what city and geographic coordinates does that correspond to?"}],"resultDescription":"Returns a JSON object containing an array of matching places (each with name, state, state code, latitude, and longitude), the full country name, the country code, the original postal code, the upstream Zippopotam.us source URL, and a timestamp of when the lookup was performed.","failureModes":["Postal code not found in Zippopotam.us data — returns empty or error response","Country code not supported by Zippopotam.us — service covers only a subset of countries","Malformed postal code (too short, too long, wrong format) — may return no results","Zippopotam.us upstream unavailable — worker may return a 5xx error","Country code provided in wrong format (e.g. 3-letter instead of 2-letter ISO) — invalid query"],"whenToPreferThis":"Use this endpoint when you need a quick, free-tier geocode of a postal code to place name and coordinates for any of the countries covered by Zippopotam.us. It is ideal for enriching address data, validating shipping regions, or plotting locations on a map when you already have a postal code and country. Prefer alternatives if you need time zone data, full administrative municipality hierarchies, or coverage of countries not in Zippopotam.us.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:43:43.327Z","isFirstParty":false,"canonicalSlug":"global-postal-code-geocoder-zippopotam-us-9c017875"}