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

Looks up places, province/state, and geographic coordinates for a given postal code in over 60 countries.

## Facts

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

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-b487e3cc -d '<json body>'
```

Example prompt: What city, province, and coordinates correspond to postal code 28001 in Spain?

## When to prefer this

Choose this endpoint when you need to resolve postal codes to human-readable place names and geographic coordinates across a wide range of countries (60+), especially for non-US markets like Spain, Germany, France, Italy, Mexico, and Brazil. Prefer it over general geocoding APIs when your input is strictly a postal code rather than a full address, and when multi-country coverage in a single API is needed at low per-call cost.

## Known failure modes

- Postal code not found in the database for the given country — returns empty or null lugares array
- Invalid or missing country ISO code — request may fail validation or return unexpected results
- Unsupported country code — only 60+ supported countries are covered, others will not return data
- Malformed postal code format — may return no results if the format doesn't match expected patterns
- Network or payment authentication failure — x402 payment errors result in HTTP 402 responses

## How this service works

Postal code lookup in more than 60 countries (ES, US, DE, FR, GB, IT, MX, BR...): places, province or state and coordinates.

## Output

Returns a structured object containing the queried postal code and country code, one or more matching places (each with name, region, region code, latitude, and longitude), and the data source used. Multiple localities may be returned when a postal code covers several towns.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "pais": {
   "type": "string",
   "description": "ISO 2-letter code"
  },
  "codigo": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-postal-code-lookup-b487e3cc/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)