Get Countries

This endpoint retrieves a list of countries along with their associated details. Use these IDs when initializing payments, processing refunds, or filtering transactions by country.

GET : v1/countries

This is a lightweight, read-only endpoint with no request body or query parameters. Authentication requires only your public key — it is safe to call from a client-side environment.

No Request Body

This endpoint accepts no query parameters or request body. Simply send the GET request with your public-key header.

Response

Returns an array of country objects. Each object contains the id you pass to other Vesicash endpoints, alongside the country name, ISO code, currency.

• Data :An array containing country objects, where each object includes:

• id: The unique identifier for the country.

• name: The name of the country.

• country_code: The ISO code representing the country.

• currency_code: The currency code associated with the country.

{
  "status": "",
  "code": 0,
  "message": "",
  "data": [
    {
      "id": "",
      "name": "",
      "country_code": "",
      "currency_code": ""
    }
  ]
}

Using country_id in Other Requests

Once you have fetched the country list, use the country_id field wherever Vesicash requires a country identifier — for example, when processing a refund.