API de IziVisas para desarrolladores

Una API JSON gratuita, sin clave ni cuenta, para comprobar los requisitos de visado de corta estancia entre dos países. CORS abierto — se puede llamar directamente desde el navegador.

Endpoint

Una única ruta de solo lectura:

GET https://izivisas.com/api/public/visa-check?from={FROM}&to={TO}&locale={LOCALE}

Parámetros

from (string — requerido) — Nacionalidad del viajero, código ISO 3166-1 alpha-2 (ej. SN).
to (string — requerido) — País de destino, código ISO 3166-1 alpha-2 (ej. FR).
locale (string — opcional) — Idioma de la respuesta: fr, en o es (por defecto: fr).

Ejemplos de petición

curl

curl "https://izivisas.com/api/public/visa-check?from=SN&to=FR&locale=es"

JavaScript (fetch)

const res = await fetch(
  'https://izivisas.com/api/public/visa-check?from=SN&to=FR&locale=es'
);
const data = await res.json();
console.log(data.verdict.regime); // "consular"

Ejemplo de respuesta

{
  "from": { "code": "SN", "name": "Sénégal" },
  "to": { "code": "FR", "name": "France" },
  "verdict": {
    "regime": "consular",
    "color": "red",
    "duration": "90 jours"
  },
  "visa": {
    "name": "Visa Schengen court séjour",
    "price": { "min": 80, "currency": "EUR" },
    "processingTime": "15 jours",
    "officialUrl": "https://france-visas.gouv.fr"
  },
  "detailsUrl": "https://izivisas.com/fr/visas/SN/FR",
  "attribution": "Visa data by IziVisas — https://izivisas.com"
}

El veredicto es el régimen más permisivo para una estancia turística corta: visaFree, onArrival, eVisa, consular o notEligible (unknown si no hay datos). El campo color (green / yellow / red / null) permite una visualización tipo semáforo. visa es null cuando no hay visado turístico referenciado; price, processingTime, officialUrl y duration pueden ser null.

Errores

400 — Códigos de país no válidos (el formato esperado es 2 letras ISO).
404 — Código de país desconocido en la base.
429 — Demasiadas peticiones — reintente tras el plazo indicado en la cabecera Retry-After.
500 — Error interno.

Caché y límites

Las respuestas se sirven con Cache-Control: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800: caché de navegador 1 h, caché CDN 24 h. Los veredictos cambian raramente — guarde la respuesta en caché en su lado en lugar de llamar a la API en cada renderizado. El endpoint está protegido por limitación de peticiones antiabuso: si se supera, devuelve 429 con una cabecera Retry-After. Para un uso intensivo, contáctenos.

Atribución requerida

La API es gratuita para cualquier sitio o aplicación. Única condición: citar IziVisas con un enlace visible a izivisas.com donde se muestren los datos. Cada respuesta incluye además un campo attribution listo para usar. Los datos son orientativos — verifique siempre las fuentes oficiales antes de viajar.

Integración sin código

¿No quiere escribir código? El verificador de visados también existe como widget integrable: una etiqueta para pegar, con la atribución incluida.

Descubrir el widget →