{"uid":"cap_sfJ2zBlxYWnq1iti9lvG7","slug":"vextorium-postal-code-lookup-cab46f35","name":"Vextorium Postal Code Lookup","description":"244 pay-per-call data APIs for AI agents: official statistics and economy (ECB, Fed, Eurostat, World Bank, SEC, BOE, INE), crypto prices and sentiment, Spanish public data, compliance (sanctions, VAT, IBAN, LEI), science, weather, web and developer tools and local AI text tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/postal-code?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"code":{"type":"string","description":"Spanish postal code, 5 digits"},"country":{"type":"string","description":"ES (only Spain is supported)"}}},"responseSchema":{"type":"json","example":{"code":"28013","note":"Municipality at the central point of the postal code; a postal code can cover more than one municipality.","places":[{"lat":40.41837136928522,"lon":-3.710476072940467,"name":"Madrid","ine_code":"28079","province":"Madrid","community":"Comunidad de Madrid","municipality":"Madrid"}],"source":"© Instituto Geográfico Nacional de España - CartoCiudad, CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Fields selected and renamed by Vextorium.","country":"Spain","country_code":"ES"}},"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_YkylKLEVkXJ55oMp4N_pu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geographic information (city name, region, coordinates) for a given postal code, optionally scoped to a specific country.","exampleAgentPrompt":"What city and region does postal code 28013 belong to? It's in Spain.","exampleUseCases":[{"title":"Enrich customer address with city and region","prompt":"I have a customer record with postal code 10001 in the US — can you look up the city and region name so I can fill in the missing address fields?"},{"title":"Validate and geolocate a delivery postcode","prompt":"Before we dispatch the shipment, check if postal code SW1A 1AA in the UK is valid and tell me the city and coordinates it maps to."},{"title":"Display location name from a postal code in a form","prompt":"A user just typed in postal code 75008 on our checkout form — look up what city and region that corresponds to in France so I can auto-fill the rest of the address."}],"resultDescription":"Returns a JSON object with the original postal code, country name and ISO code, and an array of matching places each containing the place name, region name, region code, latitude, and longitude. Also includes the data source attribution (Zippopotam.us / GeoNames).","failureModes":["Unknown or invalid postal code returns empty places array or error","Missing required 'code' field in request body causes validation error","Incorrect country code may return no results or wrong region","Postal codes that map to multiple localities return multiple entries in the places array","Some countries have limited or no postal code coverage in GeoNames"],"whenToPreferThis":"Use this endpoint when you need to resolve a postal code to a human-readable city/region name or geographic coordinates, especially for address enrichment, form auto-fill, or delivery validation. It covers international postal codes (not just US ZIP codes) and returns structured place data including lat/lon. Prefer this over geocoding APIs when you already have the postal code and want fast, cheap structured lookup without needing a full address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:45:19.797Z","isFirstParty":false,"canonicalSlug":"vextorium-postal-code-lookup-b487e3cc"}