List all (or one) countries.

Endpoint URL

Authentication and rate limits

Authentication methodOAuth 2.0 Bearer token
Rate limitRate Limit

Requests Example

curl --request GET \
  --url '' \
  --header 'Authorization: Bearer $BEARER_TOKEN'
curl --request GET \
  --url '$id' \
  --header 'Authorization: Bearer $BEARER_TOKEN'

Query Parameters

  • id (integer) --

    Optional if you want to list a specific country ID. The id parameter is passed as part of the request url /country/$id.

Response Syntax

  "country_name": "string",
  "country_numeric_code": integer

Response Fields

  • country_name (string) --

    The name of the country.

  • country_numeric_code (integer) --

    The numeric code of the country.