Country data

Ce endpoint renvoi les données disponibles sur un pays (noms, codes, gentilés, devises, langues, pays frontaliers, etc).

Request

GET  https://connect.visamundi.io/v3/country/{id}

Dans cette requête, {id} doit être remplacé par un code pays suivant la norme ISO 3166-1 (Vous pouvez utiliser les codes à 2 ou 3 lettres).

Example:

GET  https://connect.visamundi.io/v3/country/FRA

Parameters of the request

Parameter		Description
`access_token`	Required	The key to authenticate you to the API. Learn more about authentication
`language`	Optional	Learn more about available languages

Response example

{
    "success": true,
    "statusCode": 200,
    "code": "ok",
    "data": {
        "country": {
            "name": {
                "common": "France",
                "official": "République française"
            },
            "cca2": "FR",
            "cca3": "FRA",
            "ccn3": "250",
            "flag": "🇫🇷",
            "slug": "france",
            "demonyms": {
                "singular": {
                    "f": "Française",
                    "m": "Français"
                },
                "plural": {
                    "f": "Françaises",
                    "m": "Français"
                }
            },
            "currencies": {
                "EUR": {
                    "name": "Euro",
                    "symbol": "€"
                }
            },
            "languages": {
                "fra": "Français"
            },
            "capital": [
                "Paris"
            ],
            "continent": "Europe",
            "hpi": 13,
            "latlng": [
                46.2276001,
                2.21374989
            ],
            "independant": true,
            "status": "officially-assigned",
            "un_member": true,
            "landlocked": false,
            "borders": [
                "DEU",
                "AND",
                "BEL",
                "ESP",
                "ITA",
                "LUX",
                "MCO",
                "CHE"
            ],
            "url": {
                "destination": "https://www.visamundi.co/destinations/inde/",
                "form": "https://form.visamundi.app/apply/in/",
                "official": "https://indianvisaonline.gov.in/"
            }
        }
    }
}

Parameters of the response

In the response, data contains an object country avec plusieurs éléments :

Parameter/Object	Description
`name`	Object containing the common name (`common`) of the country as well as its official name (`official`).
`cca2`	2-letter country code based on ISO 3166-1. Learn more about country codes
`cca3`	3-letter country code based on ISO 3166-1. Learn more about country codes
`ccn3`	Numeric country code based on ISO 3166-1.
`flag`	Emoji flag
`slug`	Slug basé sur le nom commun du pays.
`demonyms`	Name given to inhabitants (singular and plural). Key: `f` (feminine) or `m` (masculine). Value: name given according to gender.
`currencies`	Objet contenant les devises utilisées dans le pays. Clé : Code à 3 lettres selon la norme ISO 4217. Valeur : Objet détaillant la devise - Key `name` Nom de la monnaie. - Key `symbol` Symbole de la monnaie.
`languages`	Objet contenant les langues parlées dans le pays. Clé : Code à 3 lettres de la langue selon la norme ISO 639-3. Valeur : Le nom de la langue.
`capital`	Tableau contenant les différentes capitales du pays.
`continent`	Nom du continent.
`hpi`	Position dans le classement Henley des passeports (Henley Passport Index).
`latlng`	Array containing the latitude and longitude of the center of the country.
`independant`	Booléen indiquant si le pays est considéré comme un État souverain.
`status`	Statut du pays selon la norme ISO 3166-1.
`un_member`	Booléen indiquant si le pays est membre des Nations Unis.
`landlocked`	Booléen indiquant si le pays est enclavé.
`borders`	Codes des pays frontaliers. Learn more about country codes
`url`	Objet contenant différentes urls liées à Visamundi : - Key `destination` URL of the page dedicated to the destination on the Visamundi website. - Key `form` URL of the visa application form for this destination. - Key `official` URL of the authorities official sebsite (Note: these URLS might be empty strings if no resources are available)

Codes and error messages

In addition to the API error codes and messages, ce endpoint peut renvoyer d’autres codes et messages :

StatusCode	Code	Description
`200`	no_country_found	« No country found » La requête s’est bien déroulée mais aucun pays n’a été trouvé.

API Endpoints