Get available countries

GET https://staging-onlinebusiness.suregifts.com/v2/countries

This endpoint retrieves the list of countries currently supported by the platform. Each country entry includes its ISO 3166-1 alpha-2 code and its full name. This information is typically used to determine valid country options for account creation, transactions, or gift card purchases.

Request

Method: GET
URL: /v2/countries
Query Parameters: None
Body: None
Notes: This request is read-only and does not affect any account or transaction state.

Responses

200 OK – Successful

JSON

{
  "data": [
    {
      "code": "KE",
      "name": "Kenya"
    },
    {
      "code": "NG",
      "name": "Nigeria"
    }
  ],
  "statusCode": "00",
  "message": "Successful"
}

Field Descriptions:

• data (array) – List of supported countries.
  • code (string) – The two-letter ISO country code.
  • name (string) – The full country name.
• statusCode (string) – Provider-specific status code ("00" indicates success).
• message (string) – Human-readable message indicating the outcome.

401 Unauthorized

Returned when the request is not authorized.

Unauthorized

403 Forbidden

Returned when the user does not have permission to access this resource.

Forbidden

500 Internal Server Error

Returned when the server encounters an unexpected condition.

Internal Server Error

Example cURL Request

Bash

curl -X GET \
  'https://{baseUrl}/v2/countries' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json'