# Names Transliteration

***

The Transliteration service allows you to convert Arabic names into their English equivalents. It is different from Translation in that it does not return the meaning of the word, but its proper pronunciation in another language. This service is very useful for faster/automated data entry.

## Transliteration (Arabic to English)

<mark style="color:green;">`POST`</mark> `https://valifystage.com/api/v1/transliterate/`

#### Headers

| Name          | Type   | Description            |
| ------------- | ------ | ---------------------- |
| Content-Type  | string | application/json       |
| Authorization | string | Bearer \<access-token> |

#### Request Body

| Name           | Type   | Description                             |
| -------------- | ------ | --------------------------------------- |
| arabic\_phrase | string | The Arabic string to be transliterated  |
| bundle\_key    | string | A bundle key provided to you by Valify. |
| lang           | string | The error message language.             |

**Status Codes**

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

```python
{
    'result': {
        'english_phrase': '<string>'
    }, 
    'transaction_id': '<string>',
    'trials_remaining': '<int>'
}
```

{% endtab %}

{% tab title="400 Missing input data" %}

```python
{
    "message": "Bad Request – invalid request received (e.g. missing Bundle key, required parameters or invalid json) | Make sure all the required parameters are included"
}
```

{% endtab %}

{% tab title="401 Invalid bundle key" %}

```python
{
    "message": "Unauthorized – your Bundle key is invalid"
}
```

{% endtab %}

{% tab title="403 Access token error" %}

```python
{
    "message": "Forbidden – specified access_token could not be found"
}
```

{% endtab %}

{% tab title="404 Check the endpoint" %}

```python
{
    "message": "Not Found"
}
```

{% endtab %}

{% tab title="415 The format should be base64" %}

```python
{
    "message": "Unsupported Media Type"
}
```

{% endtab %}

{% tab title="422 Check Valify error codes" %}

```python
{
    "message": "<error-description>",
    "error_code": <valify-error-code>
}
```

{% endtab %}

{% tab title="500 Contact us" %}

```python
{
    "message": "Internal Server Error"
}
```

{% endtab %}
{% endtabs %}

## <mark style="color:blue;">Postman Collection</mark>

{% file src="<https://641522850-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmzgYXwSfAFtfOUAPpKlY%2Fuploads%2Fh5vPhujBmqSd0goWg2YA%2FDocumentation%20-%20Transliteration%20(Arabic%20to%20English)%20(v1).postman_collection?alt=media&token=9e46c24b-40a5-49e7-abb7-4ad180b5360c>" %}
Transliteration (Arabic to English)
{% endfile %}