API IziVisas pour développeurs

Une API JSON gratuite, sans clé ni compte, pour vérifier les exigences de visa court séjour entre deux pays. CORS ouvert — appelable directement depuis le navigateur.

Endpoint

Une seule route, en lecture seule :

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

Paramètres

from (string — requis) — Nationalité du voyageur, code ISO 3166-1 alpha-2 (ex. SN).
to (string — requis) — Pays de destination, code ISO 3166-1 alpha-2 (ex. FR).
locale (string — optionnel) — Langue de la réponse : fr, en ou es (défaut : fr).

Exemples de requête

curl

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

JavaScript (fetch)

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

Exemple de réponse

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

Le verdict correspond au régime le plus permissif pour un court séjour touristique : visaFree, onArrival, eVisa, consular ou notEligible (unknown si aucune donnée). Le champ color (green / yellow / red / null) permet un affichage feu tricolore. visa vaut null quand aucun visa touristique n’est référencé ; price, processingTime, officialUrl et duration peuvent être null.

Erreurs

400 — Codes pays invalides (le format attendu est 2 lettres ISO).
404 — Code pays inconnu de la base.
429 — Trop de requêtes — réessayez après le délai indiqué par l’en-tête Retry-After.
500 — Erreur interne.

Cache et limites

Les réponses sont servies avec Cache-Control: public, max-age=3600, s-maxage=86400, stale-while-revalidate=604800 : cache navigateur 1 h, cache CDN 24 h. Les verdicts changent rarement — mettez la réponse en cache de votre côté plutôt que d’appeler l’API à chaque affichage. L’endpoint est soumis à une limitation de débit anti-abus : en cas de dépassement, il répond 429 avec un en-tête Retry-After. Pour un usage intensif, contactez-nous.

Attribution requise

L’API est gratuite pour tout site ou application. Seule condition : citer IziVisas avec un lien visible vers izivisas.com là où les données sont affichées. Chaque réponse inclut d’ailleurs un champ attribution prêt à l’emploi. Les données sont fournies à titre indicatif — vérifiez toujours auprès des sources officielles avant de voyager.

Intégration sans code

Vous ne voulez pas écrire de code ? Le vérificateur de visa existe aussi en widget embarquable : une balise à coller, l’attribution est intégrée.

Découvrir le widget →