← Back to API index
GET /country/list

List available countries

Options

Options are grouped for easier scanning, similar to parameter-focused docs.

App

key

query string Optional

API key (optional if using JWT bearer token)

API key used for authentication. Use either the `key` query parameter or `X-API-KEY` header.

Responses

200

Country list

▾ 
{
  "success": true,
  "data": [
    {
      "name": "us",
      "display_name": "United States",
      "region": "America"
    },
    {
      "name": "gb",
      "display_name": "United Kingdom",
      "region": "Europe"
    }
  ]
}
401

Unauthorized

▾ 
{
  "success": false,
  "error": "Unauthorized",
  "code": "UNAUTHORIZED"
}
403

Forbidden

▾ 
{
  "success": false,
  "error": "Forbidden",
  "code": "FORBIDDEN"
}
500

Server error

▾ 
{
  "success": false,
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}