Exigence de visa

Ce endpoint donne accès à plusieurs informations :

  • Détails sur le pays de la nationalité et sur celui de destination permettant de composer une phrase pour un affichage sur votre site internet ou application.
  • Information sur l’exigence ou non d’un visa ou d’un document de voyage.
  • Liste des visas possibles et des documents nécessaires pour leurs obtentions.

Requête

GET  https://connect.visamundi.io/v3/partner/{name}/requirements

Dans cette requête, {name} doit être remplacé par votre identifiant. Celui-ci, en association avec votre clé API, vous permettra d’obtenir les informations souhaités.

Paramètres de la requête

ParamètreDescription
access_tokenRequisLa clé permettant de vous authentifier auprès de l’API.
En savoir plus sur la clé API
languageOptionnelEn savoir plus sur les langues disponibles
nationalityRequisCode à 2 ou 3 caractères suivant la norme ISO 3166-1.
En savoir plus
destinationRequisCode à 2 ou 3 caractères suivant la norme ISO 3166-1.
En savoir plus

Exemple de réponse

{
    "success": true,
    "statusCode": 200,
    "code": "ok",
    "data": {
        "nationality": {
            "name": {
                "common": "France",
                "official": "République française"
            },
            "cca2": "FR",
            "cca3": "FRA",
            "demonyms": {
                "singular": {
                    "f": "Française",
                    "m": "Français"
                },
                "plural": {
                    "f": "Françaises",
                    "m": "Français"
                }
            }
        },
        "destination": {
            "name": {
                "common": "Inde",
                "official": "République de l'Inde"
            },
            "cca2": "IN",
            "cca3": "IND",
            "demonyms": {
                "singular": {
                    "f": "Indienne",
                    "m": "Indien"
                },
                "plural": {
                    "f": "Indiennes",
                    "m": "Indiens"
                }
            },
            "url": {
                "destination": "https://www.visamundi.co/destinations/inde/",
                "form": "https://form.visamundi.app/apply/in/"
            }
        },
        "requirement": "e-visa",
        "visas": [
            {
                "name": "e-Visa Business",
                "reasons": {
                    "business": "Affaires / Business"
                },
                "stay_duration": 180,
                "validity_duration": 365,
                "documents": [
                    {
                        "name": "Passeport",
                        "specificity": "valide au moins 6 mois"
                    },
                    {
                        "name": "Photo d'identité",
                        "specificity": ""
                    },
                    {
                        "name": "Carte de visite",
                        "specificity": ""
                    },
                    {
                        "name": "Lettre d'invitation",
                        "specificity": ""
                    }
                ]
            },
            ...
        ]
    }
}

Paramètres de réponse

Dans la réponse, data contient plusieurs objets et éléments :

Paramètre/ObjetDescription
nationalityObjet Pays (en version simplifiée).
destinationObjet Pays (en version simplifiée).

Cet objet contient également une propriété url :
– Clé destination Url de la page dédiée à la destination sur le site Visamundi.
– Clé form Url du formulaire de demande de visa pour cette destination
requirementExigence ou non de visa ou de document de voyage.
visasTableau d’objets contenant les visas disponibles pour la paire nationalité/destination.
– Clé name Nom du visa.
– Clé reasons Raisons de voyage liés à ce visa.
– Clé stay_duration Durée maximal de séjour dans le pays de destination (En jours).
– Clé validity_duration Durée de validité du visa (En jours).
– Clé documents Tableau des documents requis pour l’obtention du visa/document de voyage.

Objet document :
– Clé name Nom du document.
– Clé specificity Spécificités à prendre en compte vis-à-vis du document en question.

Précisions sur l’exigence de visa/document de voyage

Valeurs possibles du paramètre requirement renvoyé avec la réponse de ce endpoint :

ValeurExplication
7365Nombre de jours sans visa, si disponible.
visa freeVoyage sans visa (lorsque le nombre de jours est inconnu ou non applicable, comme la liberté de mouvement), y compris l’obligation d’enregistrement touristique pour les Seychelles.
visa on arrivalDestination qui accorde un visa à l’arrivée, essentiellement sans visa.
e-visaUn document de voyage ou visa électronique est requis.
visa requiredL’obtention d’un visa est obligatoire pour voyager. Comprend les cartes touristiques de Cuba.
no admissionComprend des situations rares, telles que des guerres.
-1Quand nationality = destination .
no dataAucune donnée disponible.

Codes et messages d’erreur

En plus des codes et messages d’erreur de l’API, ce endpoint peut renvoyer certains autres codes et messages :

StatusCodeCodeDescription
200no_country_found« No country found »
La requête s’est bien déroulée mais les pays passés avec les paramètres nationality ou destination n’ont pas été trouvé.
400required_parameters_error« Missing or incorrect required parameters »
Les paramètres nationality ou destination n’ont pas été envoyés avec la requête ou ne respectent pas le format attendu.
403country_restrictions« Your account has a restriction on this country »
Votre compte possède une restriction et ne peut afficher que les contenus de certains pays.
403forbidden« Partner ID and API key do not match »
Le paramètre {name} dans l’url du endpoint ne correspond pas à la clé d’authentification.