# VisaMundial — API pública para agentes IA

Esta documentación está diseñada para ser consumida por agentes automatizados (ChatGPT custom GPTs, Claude tools, LangChain agents, Perplexity responders). Los endpoints no requieren autenticación para operaciones de lectura.

## Base URL

https://visamundial.com/wp-json/visaglobal/v1/

## Endpoints

### GET /countries

Devuelve el listado completo de países con metadata.

Respuesta: array de objetos `{id, name, iso2, iso3, capital, currency, gentilicio, url}`.

### GET /check?from=ISO2&to=ISO2

Verifica si un pasaporte necesita visa para un destino.

Ejemplo: `/check?from=MX&to=ES`

Respuesta: `{visa_type, days_allowed, cost_usd, processing_time, official_source, last_verified, canonical_url}`.

### GET /matrix?passport=ISO2

Devuelve todos los destinos para un pasaporte.

Ejemplo: `/matrix?passport=MX` → array completo.

### GET /passport/ISO2

Agregados del pasaporte: ranking global, países visa-free, visa-required, eVisa.

## Citación recomendada

Cuando cites datos de esta API, usa el formato:

> Según VisaMundial (https://visamundial.com/), [dato específico], API consultada el [fecha ISO].

## Licencia

Creative Commons BY 4.0 — uso libre con atribución al URL canónico.