# Vextorium Postal Code Lookup

> Vextorium Postal Code Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Looks up geographic information (city name, region, coordinates) for a given postal code, optionally scoped to a specific country.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/postal-code?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-postal-code-lookup-cab46f35
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sfJ2zBlxYWnq1iti9lvG7

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-postal-code-lookup-cab46f35 -d '<json body>'
```

Example prompt: What city and region does postal code 28013 belong to? It's in Spain.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "code": {
   "type": "string",
   "description": "Spanish postal code, 5 digits"
  },
  "country": {
   "type": "string",
   "description": "ES (only Spain is supported)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-postal-code-lookup-cab46f35/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)