# Voices & Languages

### 1. Get Languages 

Safi supports multiple languages fluently. You can fetch them below and append to any request/response.

<mark style="color:green;">`GET`</mark>  `/language/list`

Headers

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

```json
GET /language/list
```

{% endcode %}
{% endtab %}

{% tab title="Response" %}

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "status": "success",
    "data": [
        {
            "name": "arabic",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "khadi",
                    "gender": "female"
                },
                {
                    "id": "khalid",
                    "gender": "male"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        },
        {
            "name": "english",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "khadi",
                    "gender": "female"
                },
                {
                    "id": "nora",
                    "gender": "female"
                },
                {
                    "id": "tolu",
                    "gender": "female"
                },
                {
                    "id": "khalid",
                    "gender": "male"
                },
                {
                    "id": "uche",
                    "gender": "male"
                },
                {
                    "id": "yemi",
                    "gender": "male"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        },
        {
            "name": "french",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        },
        {
            "name": "hausa",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "khadi",
                    "gender": "female"
                },
                {
                    "id": "khalid",
                    "gender": "male"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        },
        {
            "name": "igbo",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "nora",
                    "gender": "female"
                },
                {
                    "id": "uche",
                    "gender": "male"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        },
        {
            "name": "pidgin",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "khadi",
                    "gender": "female"
                },
                {
                    "id": "nora",
                    "gender": "female"
                },
                {
                    "id": "tolu",
                    "gender": "female"
                },
                {
                    "id": "khalid",
                    "gender": "male"
                },
                {
                    "id": "uche",
                    "gender": "male"
                },
                {
                    "id": "yemi",
                    "gender": "male"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        },
        {
            "name": "yoruba",
            "voices": [
                {
                    "id": "safi",
                    "gender": "neutral"
                },
                {
                    "id": "tolu",
                    "gender": "female"
                },
                {
                    "id": "yemi",
                    "gender": "male"
                },
                {
                    "id": "idan",
                    "gender": "male"
                }
            ],
            "listening": true,
            "text": true
        }
    ],
    "message": "Fetched Account Languages.",
    "code": 0
}
</code></pre>

{% endtab %}
{% endtabs %}

***

### 2. Get Voices

By default Safi speaks all its supported languages fluently, however, you should specify voice name if you want to customize or get a specific voice with every request.

<mark style="color:green;">`Get`</mark> `/voice/list`

Headers

| Name         | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |
| apiKey       | string           |
| secret       | string           |

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

```json
GET /voice/list
```

{% endtab %}

{% tab title="Response" %}

```json
"status":"success",
"data": [
    {
        "id": "safi",
        "gender": "neutral"
    },
    {
        "id": "khadi",
        "gender": "female"
    },
    {
        "id": "nora",
        "gender": "female"
    },
    {
        "id": "tolu",
        "gender": "female"
    },
    {
        "id": "khalid",
        "gender": "male"
    },
    {
        "id": "uche",
        "gender": "male"
    },
    {
        "id": "yemi",
        "gender": "male"
    },
    {
        "id": "idan",
        "gender": "male"
    }
    ],
"code":0,
"message":"Fetched voices"
```

{% endtab %}
{% endtabs %}