alpha: Get multiple countries by codes

API: restcountries.com:rest-countries-api
Endpoint: /alpha
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 381ms

Description

Get multiple countries at once by providing a comma-separated list of alpha codes via the codes query parameter. This is efficient for batch lookups when you need data for several known countries in one request. Returns an array of country objects.

From spec: Get multiple countries by providing comma-separated country codes via the 'codes' query parameter.

Usage Tips

- Use codes query param: `/alpha?codes=us,gb,fr` - Accepts mixed 2-letter and 3-letter codes - Order of codes does not guarantee order in response - Maximum practical limit depends on URL length, but dozens of codes work fine

Parameters (2)

codes (string, query, required)

Comma-separated list of country codes

fields (string, query, optional)

Comma-separated list of fields to include (max 10)

Examples (7)

Get multiple countries by code openapi-spec

Get US, UK, and France in one request

curl 'https://restcountries.com/v3.1/alpha?codes=us%2Cgb%2Cfr'
import requests

resp = requests.get(
    "https://restcountries.com/v3.1/alpha",
    params={
        'codes': 'us,gb,fr',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="us,gb,fr")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3.1/alpha?codes=us%2Cgb%2Cfr");
const data = await resp.json();
Search by multiple codes openapi-spec

Get Germany, USA, France by alpha-3 codes

curl 'https://restcountries.com/v3.1/alpha?codes=DEU%2CUSA%2CFRA'
import requests

resp = requests.get(
    "https://restcountries.com/v3.1/alpha",
    params={
        'codes': 'DEU,USA,FRA',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="DEU,USA,FRA")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3.1/alpha?codes=DEU%2CUSA%2CFRA");
const data = await resp.json();
Get multiple countries by codes openapi-spec

Get Germany, France, Italy by codes (v3)

curl 'https://restcountries.com/v3/alpha?codes=de%2Cfr%2Cit'
import requests

resp = requests.get(
    "https://restcountries.com/v3/alpha",
    params={
        'codes': 'de,fr,it',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="de,fr,it")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3/alpha?codes=de%2Cfr%2Cit");
const data = await resp.json();
Get multiple countries by codes openapi-spec
curl 'https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit&fields=name%2Ccapital'
import requests

resp = requests.get(
    "https://restcountries.com/v3.1/alpha",
    params={
        'codes': 'de,fr,it',
        'fields': 'name,capital',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="de,fr,it", fields="name,capital")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit&fields=name%2Ccapital");
const data = await resp.json();
Get multiple countries by codes probe-gate
curl 'https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit&fields=name%2Ccapital'
import requests

resp = requests.get(
    "https://restcountries.com/v3.1/alpha",
    params={
        'codes': 'de,fr,it',
        'fields': 'name,capital',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="de,fr,it", fields="name,capital")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit&fields=name%2Ccapital");
const data = await resp.json();
Get multiple countries by codes openapi-spec
curl 'https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit'
import requests

resp = requests.get(
    "https://restcountries.com/v3.1/alpha",
    params={
        'codes': 'de,fr,it',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="de,fr,it")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit");
const data = await resp.json();
Get multiple countries by codes probe-gate
curl 'https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit'
import requests

resp = requests.get(
    "https://restcountries.com/v3.1/alpha",
    params={
        'codes': 'de,fr,it',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("restcountries")
result = api.fetch("alpha", codes="de,fr,it")

for item in result:
    print(item)
const resp = await fetch("https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:29:38.249838 200 381ms
2026-04-16 16:55:12.778926 200 3675ms
2026-04-16 03:20:14.580977 200 375ms
2026-04-16 02:26:52.587895 200 379ms
2026-04-16 01:58:56.923773 200 379ms
2026-04-16 01:35:13.168007 200 481ms
2026-04-16 01:30:54.250435 200 415ms
2026-04-16 00:24:29.975265 200 484ms
2026-04-16 00:23:03.746416 200 379ms
2026-04-15 02:34:33.815462 200 423ms
2026-04-15 01:41:23.539574 200 389ms
2026-04-15 01:12:34.493327 200 433ms
2026-04-15 00:49:28.014176 200 500ms
2026-04-15 00:35:33.167978 200 491ms
2026-04-15 00:29:04.122969 200 375ms
2026-04-15 00:03:37.467853 200 379ms
2026-04-14 03:41:50.081673 200 382ms
2026-04-14 03:34:09.163021 200 525ms
2026-04-14 03:14:59.266477 200 381ms
2026-04-14 03:13:26.736250 200 377ms
2026-04-14 02:17:54.487000 200 519ms
2026-04-14 00:46:49.238542 200 534ms
2026-04-14 00:20:05.637250 200 411ms
2026-04-12 15:46:44.874376 200 389ms
2026-04-12 15:36:35.431651 200 466ms
2026-04-12 14:56:09.092740 200 358ms
2026-04-12 13:29:54.242930 200 379ms
2026-04-12 13:27:23.617599 200 462ms
2026-04-12 13:17:41.640621 200 401ms
2026-04-12 12:45:42.879124 200 382ms
2026-04-10 06:48:23.261223 200 385ms
2026-04-10 04:28:28.779045 200 923ms
2026-04-10 02:51:47.345728 200 364ms
2026-04-10 02:49:42.072115 200 349ms
2026-04-10 02:06:55.500761 200 1069ms
2026-04-10 01:20:13.393171 200 306ms
2026-04-10 00:27:00.744939 200 308ms
2026-04-09 03:47:49.539667 200 719ms
2026-04-09 03:22:38.085880 200 375ms
2026-04-09 02:49:31.502275 200 524ms
2026-04-09 01:39:50.911826 200 584ms
2026-04-09 01:25:32.933373 200 536ms
2026-04-09 01:21:07.235025 200 509ms
2026-04-09 01:11:09.362413 200 445ms
2026-03-28T06:10:46.484046 200 355ms
2026-03-23 10:43:03.951224 200 322ms
2026-03-23 10:26:16.870091 200 437ms
2026-03-23 10:20:55.597807 200 410ms
2026-03-23 10:10:07.804802 200 341ms
2026-03-23 09:26:01.659787 200 316ms