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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vesicash.com/get-countries.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.