{"uid":"cap_CoPj6KzobiwHE0KwsfCiV","slug":"foundry-postal-code-lookup-a71adb83","name":"Foundry Postal Code Lookup","description":"Zip and postal code lookup: place names, state and coordinates for 60+ countries. Input: 'US 90210' or 'DE 10115'.","url":"https://minty-sprout.onrender.com/v1/postal-code?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","maxLength":8000,"description":"'<country> <postal code>'"}}},"responseSchema":{"type":"json","example":{"places":[{"lat":"34.0901","lon":"-118.4065","name":"Beverly Hills","state":"California"}],"source":"Zippopotam.us","country":"United States","postal_code":"90210"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fCqYWYIW8Hicc4lZFW-j1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up place names, state/region, and geographic coordinates for a postal or ZIP code in 60+ countries.","exampleAgentPrompt":"What city, state, and coordinates does ZIP code 90210 belong to in the US?","exampleUseCases":[{"title":"Enrich order data with city info","prompt":"I have a US ZIP code 10001 from a customer order — can you tell me what city and state that corresponds to, and give me the lat/lon too?"},{"title":"Verify international postal code location","prompt":"What place does German postal code 10115 belong to, and what are its coordinates?"},{"title":"Geolocate user-submitted postal code","prompt":"A user signed up with postal code SW1A 1AA in the UK — can you look up what city and region that maps to, along with the latitude and longitude?"}],"resultDescription":"Returns a JSON object with the country name, postal code, and a list of matching places — each with a place name, state/region, latitude, and longitude. The source is attributed to Zippopotam.us.","failureModes":["Invalid or non-existent postal code returns empty places array","Unsupported country code may yield no results","Malformed input (missing country or code) may return an error","Network timeout on Render.com cold start for infrequently called endpoints"],"whenToPreferThis":"Use this endpoint when you need lightweight postal-code-to-location resolution (city, state, coordinates) for 60+ countries without requiring a full geocoding pipeline. It is ideal for address enrichment, form validation, and geolocation from ZIP/postal codes when you already have the country code. Prefer a full geocoding API if you need street-level address parsing or reverse geocoding from coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:42.757Z","isFirstParty":false,"canonicalSlug":"foundry-postal-code-lookup-a71adb83"}