Skip to main content
GET
/
api
/
v1
/
countries
List countries
curl --request GET \
  --url http://localhost:3000/api/v1/countries \
  --header 'Authorization: Bearer <token>'
{
  "countries": [
    {
      "id": "ctry_sweden12",
      "name": "Sweden",
      "iso2_code": "SE"
    }
  ],
  "pagination": {
    "count": 1,
    "next_cursor": null
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication using Bearer token

Headers

​
Authorization
string
required

Bearer token for authentication

Query Parameters

​
limit
integer

Number of countries to return per page (default 25, max 100).

​
cursor
string

Opaque pagination cursor from a previous response.

​
fields
string

Comma-separated list of fields to include. Available fields: id, name, iso2_code.

Response

200 - application/json

Countries retrieved successfully

​
countries
object[]
required
​
pagination
object