Get countries

Overview

Get the full list of countries as {label, value} pairs, ordered by name. The endpoint caches the result forever under countries_list_v2.

Prerequisites

• No authentication required — this endpoint is public.

Base URL

Endpoint

GET /api/v1/address/countries

Authentication

• No bearer token required.

• Who can call it: Anyone — this is a public reference endpoint with no role scoping.

• No authentication required.

• Public reference endpoint under the group (called by the SPA before login).

• No role scoping — anyone gets the same global list.

Rate limit

• 100 requests/min.

Request

• No path params, query params, or body.

Response

• data.data[] (array of objects) — every country.
• label (string) — country name.
• value (string) — ISO country code.

200 Success · 200

{
  "data": {
    "data": [
      { "label": "Australia", "value": "AU" },
      { "label": "Canada", "value": "CA" },
      { "label": "United States", "value": "US" }
    ]
  }
}

Errors

Example request

curl --request GET \
  --url "https://production-api.shoutaboutus.com/api/v1/address/countries" \
  --header 'Accept: application/json'