# Vextorium Country Profile API

> Vextorium Country Profile API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-16).

Returns a comprehensive country profile including ISO codes, capital coordinates, region, income level, phone prefix, time zones, population, and GDP per capita from World Bank and libphonenumber data.

## Facts

- Endpoint: POST https://api.vextorium.com/pais-info-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-country-profile-api-215a1ddf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2JGdGvcc9bk8GwJ53GdhQ

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-country-profile-api-215a1ddf -d '<json body>'
```

Example prompt: Can you pull up the full country profile for Japan — I need the capital and its coordinates, population, GDP per capita, phone prefix, and time zones?

## When to prefer this

Use this endpoint when you need a single-call, structured country profile combining geographic, economic, demographic, and telecom data. It is especially useful for enriching user records, building country-selector UIs, or performing market research without having to aggregate multiple data sources. Prefer over rolling your own World Bank API calls when you need phone prefixes and time zones alongside economic indicators in one response.

## Known failure modes

- Invalid or unrecognized ISO code returns null or error response
- Missing or null fields for small territories or disputed regions with limited World Bank data
- GDP or population data may be a few years old for countries with infrequent World Bank reporting
- Network timeout or service unavailability returns HTTP error

## How this service works

Country profile: name, ISO codes, capital and its coordinates, region, income level, phone prefix, time zones and latest population and GDP per capita. World Bank and libphonenumber data.

## Output

A JSON object containing: country name, ISO2 and ISO3 codes, capital city name, capital latitude/longitude, World Bank region, income level classification, international phone prefix, list of time zones, latest population figure with year, and latest GDP per capita in USD with year. Data sourced from World Bank (CC BY 4.0) and libphonenumber.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "iso2": "ES",
  "iso3": "ESP",
  "fuente": "Banco Mundial (CC BY 4.0) y libphonenumber",
  "nombre": "Spain",
  "region": "Europe & Central Asia",
  "capital": "Madrid",
  "poblacion": {
   "anio": 2025,
   "valor": 49355143
  },
  "nivel_renta": "High income",
  "zonas_horarias": [
   "Europe/Madrid"
  ],
  "pib_per_capita_usd": {
   "anio": 2025,
   "valor": 38627.25
  },
  "prefijo_telefonico": "+34",
  "capital_coordenadas": {
   "lat": 40.4167,
   "lon": -3.70327
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-country-profile-api-215a1ddf/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)