Authentication

To access the Visamundi API, you must have an API key that allows you to authenticate query requests to it.

Depuis février 2025, la nouvelle version de l’API est la v3. Cela change uniquement l’URL de base ainsi que la manière de s’authentifier. Le contenu des réponses générées par l’API est le même entre la v2 et la v3.

L’URL de l’API Visamundi passe de https://api.visamundi.io/v2/ à https://connect.visamundi.io/v3/. De plus, le paramètre GET recevant votre clé API n’est plus le même, il passe de apikey à access_token.

There are two ways to authenticate query requests:

GET Parameter

You can pass your API key with every request by adding apikey (v2) ou access_token (v3) en tant que paramètre GET à votre requête.

ATTENTION
This method could expose your API key in access logs and such. Sending the API key via HTTP header as specified below works around this issue.

v3

Example of a request with authentication via the GET parameter:

GET  https://connect.visamundi.io/v3/ENDPOINT?access_token=VOTRE-CLE-API

v2

Example of a request with authentication via the GET parameter:

GET  https://api.visamundi.io/v2/ENDPOINT?apikey=VOTRE-CLE-API

HTTP Header

v3

Example of a request with authentication via the HTTP header:

curl "https://connect.visamundi.io/v3/ENDPOINT" -H "Authorization: Bearer VOTRE-CLE-API"

v2

Example of a request with authentication via the HTTP header:

curl "https://api.visamundi.io/v2/ENDPOINT" -H "apikey: YOUR-API-KEY"