API is live · Fair use

Een gratis Country API
met vlaggen, belcodes & meer.

Snelle JSON-endpoints voor landgegevens — vlaggen, wapenschilden, talen, valuta, belcodes en ISO-codes. Aangeboden door Nexperts BV.

Bekijk endpoints Probeer /nl
245
Landen
19
Endpoints
€0
Kosten
JSON
Formaat
nl de fr gb us jp br za au ca in mx
Quick start

In één request
aan de slag.

Geen API-key, geen registratie. Doe een GET-request en je krijgt direct JSON terug met alles wat je nodig hebt over een land.

Geen auth CORS-friendly Gecachet UTF-8
$ curl https://countries.nexperts.nl/nl
↳ retourneert JSON met name, flags, currencies, languages, callingcode, …
Reference

Alle endpoints

Method Endpoint Beschrijving Probeer
GET /{code} Land op ISO 3166-1 Alpha-2 code (bijv. NL, de). Case-insensitive. /nl
GET /countries Volledige lijst van geldige ISO 3166-1 Alpha-2 codes. /countries
GET /countrycode/{code} Directe lookup uit de cache (skipt validatie en upstream call). /countrycode/nl
GET /name/{name} Zoek op landnaam (min. 3 letters, spaties als _). /name/united_kingdom
GET /callingcode/{number} Lookup op internationale belcode (bijv. 31, 49). /callingcode/49
GET /cca3/{code} Lookup op ISO 3166-1 Alpha-3 code (bijv. NLD, deu). /cca3/nld
GET /region/{name} Alle landen in een regio: europe, asia, africa, americas, oceania, antarctic. /region/europe
GET /subregion/{name} Alle landen in een subregio (bijv. western_europe, south-eastern_asia). /subregion/western_europe
GET /currency/{code} Alle landen die deze valuta gebruiken (bijv. EUR, USD). /currency/eur
GET /language/{code} Alle landen waar deze taal gesproken wordt (ISO 639-3, bijv. nld, fra, eng). /language/nld
GET /capital/{name} Zoek op hoofdstad (substring match, min. 3 letters). Ondersteunt landen met meerdere hoofdsteden. /capital/amsterdam
GET /border/{code} Buurlanden van een land (cca2). Lege array als het land geen landgrenzen heeft. /border/nl
GET /timezone/{offset} Landen in een tijdzone. Format +0100, -0500, +0530 (UTC-prefix optioneel). /timezone/+0100
GET /independent Alle onafhankelijke landen. /independent
GET /un-members Alle lidstaten van de Verenigde Naties. /un-members
GET /landlocked Alle landen zonder kustlijn. /landlocked
GET /random Een willekeurig land — handig voor demo's en quizzen. /random
GET /flags/{file} Vlag-afbeelding (.png of .svg). /flags/nl.svg
GET /coa/{file} Wapenschild (.png of .svg). /coa/nl.svg
Examples

Probeer het direct

/nl
/cca3/nld
/region/europe
/subregion/western_europe
/currency/eur
/language/nld
/callingcode/49
/random
/capital/amsterdam
/border/nl
/timezone/+0100
/landlocked
Via curl
$ curl https://countries.nexperts.nl/nl
$ curl https://countries.nexperts.nl/name/united_kingdom
$ curl https://countries.nexperts.nl/callingcode/49
Via JavaScript
const res = await fetch('https://countries.nexperts.nl/nl');
const [country] = await res.json();
console.log(country.name.common); // "Netherlands"
Response

Voorbeeld JSON-response

Een GET op /nl retourneert een array met één land-object dat er als volgt uitziet (ingekort):

GET https://countries.nexperts.nl/nl 
[
  {
    "name": {
      "common": "Netherlands",
      "official": "Kingdom of the Netherlands"
    },
    "cca2": "NL",
    "cca3": "NLD",
    "capital": ["Amsterdam"],
    "region": "Europe",
    "languages": { "nld": "Dutch" },
    "currencies": {
      "EUR": { "name": "Euro", "symbol": "€" }
    },
    "idd": { "root": "+3", "suffixes": ["1"] },
    "population": 16655799,
    "flag": "🇳🇱",
    "flags": {
      "png": "https://countries.nexperts.nl/flags/nl.png",
      "svg": "https://countries.nexperts.nl/flags/nl.svg"
    },
    "coatOfArms": {
      "png": "https://countries.nexperts.nl/coa/nl.png",
      "svg": "https://countries.nexperts.nl/coa/nl.svg"
    },
    "timezones": ["UTC+01:00"],
    "continents": ["Europe"]
  }
]
Fair use

Geen rate limit, maar gebruik 'm verstandig. Cache resultaten aan jouw kant waar mogelijk.

Lokaal gecachet

Alle data, vlaggen en wapens worden lokaal geserveerd voor snelle responstijden.

No-warranty

Best effort uptime. Voor productie met SLA — neem contact op met Nexperts voor een dedicated setup.