> For the complete documentation index, see [llms.txt](https://docs.tylt.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tylt.money/tylt-embedded-wallet-service/supporting-apis/get-countires-list.md).

# Get Countires List

This endpoint allows you to retrieve the list of countries.

**Endpoint**

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/common/getCountriesList`

**Request Headers**

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

<table data-full-width="true"><thead><tr><th width="133">Name</th><th width="79">Type</th><th width="167">Example</th><th>Description</th></tr></thead><tbody><tr><td>X-TLP-APIKEY</td><td>string</td><td>93ee3c5e133697251b5362bcf9cc8532476785t8768075616f58d88</td><td>Your Tylt API Key, used to identify your account in API requests.</td></tr><tr><td>X-TLP-SIGNATURE</td><td>string</td><td>d0afef3853dfc8489c8b9affa5825171fdd7y7685675e4966a05f66ed2b3eaf9462b3c9c0</td><td>HMAC SHA-256 signature generated using the API Secret Key to secure the request.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
When using the API, ensure to include your API Key and generate the signature for the request payload using your API Secret. The tables provided above contain example values for illustration purposes only. Please refer to the code snippets for detailed instructions on how to sign the request and generate the signature properly.
{% endhint %}

**Code Snippet**

{% tabs %}
{% tab title="Node JS" %}

```javascript
import axios from "axios";
import { createHmac } from "node:crypto";

// Replace with your API Key and Secret
const apiKey = "your-api-key";
const apiSecret = "your-api-secret";

// No query parameters
const queryParams = "{}";

// Create the HMAC SHA-256 signature
const signature = createHmac("sha256", apiSecret)
  .update(queryParams)
  .digest("hex");

// Define headers
const headers = {
  "X-TLP-APIKEY": apiKey,
  "X-TLP-SIGNATURE": signature
};

// Send the GET request
axios
  .get("https://api.tylt.money/common/getCountriesList", { headers })
  .then((response) => {
    console.log("Response:", response.data);
  })
  .catch((error) => {
    console.error(
      "Error:",
      error.response ? error.response.data : error.message
    );
  });
```

{% endtab %}

{% tab title="Python" %}

```python
import hashlib
import hmac

import requests

# Replace with your API Key and Secret
api_key = "your-api-key"
api_secret = "your-api-secret"

# No query parameters
query_params = "{}"

# Create the HMAC SHA-256 signature
signature = hmac.new(
    api_secret.encode("utf-8"),
    query_params.encode("utf-8"),
    hashlib.sha256
).hexdigest()

# Define headers
headers = {
    "X-TLP-APIKEY": api_key,
    "X-TLP-SIGNATURE": signature
}

# Send the GET request
try:
    response = requests.get(
        "https://api.tylt.money/common/getCountriesList",
        headers=headers,
        timeout=30
    )

    response.raise_for_status()
    print("Response:", response.json())

except requests.RequestException as error:
    if error.response is not None:
        try:
            print("Error:", error.response.json())
        except ValueError:
            print("Error:", error.response.text)
    else:
        print("Error:", str(error))
```

{% endtab %}
{% endtabs %}

**Response**

The response has been truncated for brevity. Only the first 10 countries are shown.

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

```json
{
  "data": [
    {
      "id": 1,
      "country": "Afghanistan",
      "countryCode": "93",
      "countryShort": "AF",
      "countryShort2": "AFG",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": 16200,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/AFG.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 2,
      "country": "Albania",
      "countryCode": "355",
      "countryShort": "AL",
      "countryShort2": "ALB",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": 7200,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/ALB.png",
      "isNeoOffRampSupported": 1
    },
    {
      "id": 3,
      "country": "Algeria",
      "countryCode": "213",
      "countryShort": "DZ",
      "countryShort2": "DZA",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": 3600,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/DZA.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 4,
      "country": "American Samoa",
      "countryCode": "1-684",
      "countryShort": "AS",
      "countryShort2": "ASM",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": -39600,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/ASM.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 5,
      "country": "Andorra",
      "countryCode": "376",
      "countryShort": "AD",
      "countryShort2": "AND",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": 7200,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/AND.png",
      "isNeoOffRampSupported": 1
    },
    {
      "id": 6,
      "country": "Angola",
      "countryCode": "244",
      "countryShort": "AO",
      "countryShort2": "AGO",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": 3600,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/AGO.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 7,
      "country": "Anguilla",
      "countryCode": "1-264",
      "countryShort": "AI",
      "countryShort2": "AIA",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": -14400,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/AIA.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 8,
      "country": "Antarctica",
      "countryCode": "672",
      "countryShort": "AQ",
      "countryShort2": "ATA",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": 0,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/ATA.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 9,
      "country": "Antigua and Barbuda",
      "countryCode": "1-268",
      "countryShort": "AG",
      "countryShort2": "ATG",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": -14400,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/ATG.png",
      "isNeoOffRampSupported": 0
    },
    {
      "id": 10,
      "country": "Argentina",
      "countryCode": "54",
      "countryShort": "AR",
      "countryShort2": "ARG",
      "signupAllowed": 1,
      "loginAllowed": 1,
      "legalAge": 18,
      "timeOffset": -10800,
      "kycMandatory": 1,
      "countryImg": "https://assets.tylt.money/country-images/ARG.png",
      "isNeoOffRampSupported": 1
    }
  ],
  "msg": ""
}
```

{% endtab %}
{% endtabs %}
