Skip to main content
GET
/
countries
List countries
curl --request GET \
  --url https://api.ceibo.me/v1/countries \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": 10,
      "name": "Argentina",
      "iso2": "AR",
      "iso3": "ARG",
      "localName": "República Argentina",
      "continent": "South America",
      "officialVisaPage": "https://www.argentina.gob.ar/interior/migraciones",
      "primaryLanguageId": 1,
      "holidaysWebsiteUrl": "https://www.argentina.gob.ar/feriados",
      "officialWebsiteUrl": "https://www.argentina.gob.ar"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 195,
    "totalPages": 10
  }
}

Authorizations

​
x-api-key
string
header
required

API key minted at developer.ceibo.me. Send on every request.

Query Parameters

​
search
string

Free-text match against the country name.

​
continent
enum<string>

Filter to a single continent.

Available options:
Africa,
Antarctica,
Asia,
Europe,
North America,
Oceania,
South America
​
sortBy
enum<string>
Available options:
name,
iso2,
iso3,
continent
​
sortOrder
enum<string>
Available options:
asc,
desc
​
page
integer
default:1
Required range: x >= 1
​
limit
integer
default:20
Required range: 1 <= x <= 100

Response

Paginated list of countries.

​
data
object[]
required
​
meta
object
required