> For the complete documentation index, see [llms.txt](https://paas.docs.machnetinc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paas.docs.machnetinc.com/api-references/data-population/country.md).

# Country

The country APIs provide the list of available countries.

**Get a list of all available countries**

#### `GET /countries`

{% tabs %}
{% tab title="Request Sample" %}

```
curl --location --request GET '{{url}}/countries' \
--header 'X-Client-Id: {{client_id}}' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json'
```

{% endtab %}

{% tab title="Response Sample" %}

```
{
     {
        "currency": {
            "code": "MXN",
            "name": "Mexican peso",
            "symbol": "MXN"
        },
        "name": "Mexico",
        "phone_code": "123",
        "three_char_code": "MEX",
        "two_char_code": "MX"
    },
   {
        "currency": {
            "code": "INR",
            "name": "Indian Rupee",
            "symbol": "I"
        },
        "name": "India",
        "phone_code": "91",
        "three_char_code": "IND",
        "two_char_code": "IN"
    }
]
```

{% endtab %}
{% endtabs %}

**Get country by code**

#### `GET /countries`**/{{countryCode}}**

{% tabs %}
{% tab title="Details" %}

|              |              |          |                                  |
| ------------ | ------------ | -------- | -------------------------------- |
| **Name**     | **Required** | **Type** | **Description**                  |
| countryCode  | Yes          | String   | Two char ISO code of the country |
| {% endtab %} |              |          |                                  |

{% tab title="Request Sample" %}

```
curl --location --request GET 'https://v4test.machpay.com/v4/countries/{{countryCode}}' \
--header 'X-Client-Id: {{client_id}}' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json'
```

{% endtab %}

{% tab title="Response Sample" %}

```
 {
     "currency": {
        "code": "INR",
        "name": "Indian Rupee",
        "symbol": "I"
    },
    "name": "India",
    "phone_code": "91",
    "three_char_code": "IND",
    "two_char_code": "IN"
}

```

{% endtab %}
{% endtabs %}