> For the complete documentation index, see [llms.txt](https://docs.vesicash.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vesicash.com/get-countries.md).

# Get Countries

<mark style="color:green;">GET</mark> : 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.

{% hint style="info" %}
**No Request Body**

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

**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.