GET /alpha

restcountries.com:rest-countries-api

Summary: Get multiple countries by codes
Operation ID: getCountriesByCodes
Auth: none

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.

Original spec description

Get multiple countries by their ISO codes using 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 ISO country codes

fields (string, query, optional)

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

Examples (5)

TitleTypeURLAction
Get multiple countries by code openapi-spec https://restcountries.com/v3.1/alpha?codes=us,gb,fr
Search by multiple codes openapi-spec https://restcountries.com/v3.1/alpha?codes=DEU,USA,FRA
Get multiple countries by codes openapi-spec https://restcountries.com/v3/alpha?codes=de,fr,it
Get multiple countries by codes openapi-spec https://restcountries.com/v3.1/alpha?codes=de,fr,it&fields=name,capital
Get multiple countries by codes probe-gate https://restcountries.com/v3.1/alpha?codes=de%2Cfr%2Cit&fields=name%2Ccapital

Probe History

Latency

Status Codes

TimeStatusLatencySize
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
2026-03-20T02:21:08.584279 200 353ms

Response Changes

WhenOldNew
2026-03-23 09:26:01.659787 01b90d50e68a 789d55b7e794
2026-03-23 10:20:55.597807 789d55b7e794 1ea594a7ada1
2026-03-23 10:26:16.870091 1ea594a7ada1 4da8def7292a
2026-03-23 10:43:03.951224 4da8def7292a 1529c4b084a5