Visa requirements

This endpoint gives access to multiple informations:

Details about the country of nationality and the country of destination to compose a sentence for display on your website or application.
Information on whether or not a visa or travel document is required.
List of possible visas and the documents required to obtain them.

Request

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

In this request, {name} must be replaced by your identifier. This, in combination with your API key, will allow you to obtain the desired information.

Parameters of the request

Parameter		Description
`access_token`	Required	The key to authenticate you to the API. Learn more about the API key
`language`	Optional	Learn more about available languages
`nationality`	Required	2 or 3 character code according to ISO 3166-1 standard. Learn more
`destination`	Required	2 or 3 character code according to ISO 3166-1 standard. Learn more

Response example

{
    "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": ""
                    }
                ]
            },
            ...
        ]
    }
}

Parameters of the response

In the response, data contains multiple objects and elements:

Parameter/Object	Description
`nationality`	Object Countries (simplified version)
`destination`	Object Countries (simplified version) This object also contains the property `url` : - 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
`requirement`	Whether or not a visa or travel document is required.
`visas`	Array of objects containing the visas available for the nationality/destination pair. - Key `name` Name of the visa - Key `reasons` Reasons linked to the visa - Key `stay_duration` Maximum length of stay in the destination country (in days). - Key `validity_duration` Maximum length of validity of the visa (in days) - Key `documents` Array of documents required for obtaining a visa/travel document. Document object: - Key `name` Name of the document. - Key `specificity` Specific features to take into account regarding the document in question.

Visa/Travel document requirement details

Possible values for the parameter requirement sent by the response of this endpoint:

Value	Description
`7` – `365`	Number of days without visa, if available.
`visa free`	Visa-free travel (where number of days is unknown or not applicable, such as freedom of movement), including tourist registration requirement for Seychelles.
`visa on arrival`	Destination that grants visa on arrival, essentially visa-free.
`e-visa`	An electronic travel document or visa is required.
`visa required`	Obtaining a visa is required for travel. Includes Cuba Tourist Cards.
`no admission`	Includes rare situations, such as wars.
`-1`	When `nationality` = `destination` .
`no data`	No data available.

Codes and error messages

In addition to the API error codes and messages, this endpoint may return certain other codes and messages:

StatusCode	Code	Description
`200`	no_country_found	« No country found » The request went well but the countries passed with the parameters `nationality` or `destination` n’ont pas été trouvé.
`400`	required_parameters_error	« Missing or incorrect required parameters » The parameters `nationality` or `destination` were not sent with the request or do not follow the expected format.
`403`	country_restrictions	« Your account has a restriction on this country » Your account has a restriction and can only view content from certain countries.
`403`	forbidden	« Partner ID and API key do not match » The parameter `{name}` in the endpoint url does not match the authentication key.

API Endpoints