Country List

Get a list of all supported countries.

Endpoint Information

Name: Get Country List
Method: GET
URL: {{BASE_URL}}/api/v1/country-list?merchantAccountId={{your_account_no}}

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Query Parameters

Parameter	Type	Required	Description
merchantAccountId	string	Yes	Your merchant account ID

Example Request

GET {{BASE_URL}}/api/v1/country-list?merchantAccountId=100001

Response

Success Response

{
  "success": true,
  "message": "Country list",
  "data": [
    {
      "id": 213,
      "name": "Sweden",
      "emoji": "🇸🇪",
      "flag": null,
      "maps": [
        {
          "country": "",
          "solution": "",
          "solution_id": ""
        }
      ],
      "name_alpha_2": "SE",
      "name_alpha_3": "SWE",
      "numeric_code": "752"
    }
  ]
}

Response Fields

Field	Type	Description
success	boolean	Request success status
message	string	Response message
data	array	Array of country objects
data[].id	integer	Country ID (use this to fetch states)
data[].name	string	Country name
data[].emoji	string	Country flag emoji
data[].name_alpha_2	string	ISO 3166-1 alpha-2 country code
data[].name_alpha_3	string	ISO 3166-1 alpha-3 country code
data[].numeric_code	string	ISO 3166-1 numeric country code

Usage

Use this endpoint to:

1. Populate country dropdowns in your checkout form.
2. Get the id required to fetch states for a specific country using the State List API.
3. specific country codes for payment requests.