Quickstart

This guide makes your first call in under a minute. You’ll need an API token. No token yet? Get a trial key in a minute, or see Authentication.

1. Make a request

Fetch metadata for a single country by its ISO code:

curl https://connect.visamundi.io/v3/country/FRA?language=en \
  -H "Authorization: Bearer $VISAMUNDI_TOKEN"

2. Read the response

{
  "success": true,
  "statusCode": 200,
  "code": "ok",
  "data": {
    "country": {
      "name": { "common": "France", "official": "French Republic" },
      "cca2": "FR",
      "cca3": "FRA",
      "flag": "🇫🇷",
      "latlng": [46.2276, 2.2137]
      // ...
    }
  }
}

On success, code is "ok" and the payload lives under data (here data.country). Check code to branch on errors: some errors still carry success: true (see Errors).

3. From JavaScript

const res = await fetch(
  'https://connect.visamundi.io/v3/country/FRA?language=en',
  { headers: { Authorization: `Bearer ${process.env.VISAMUNDI_TOKEN}` } },
);
const body = await res.json();
if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`);
console.log(body.data.country.name.common); // "France"

Next steps

• Explore every endpoint interactively in the API reference — it’s the complete, live source of truth for paths, fields, and responses.