# Commercial Register Translation

***

Valify's Commercial Register Transliteration is designed to enable organizations to seamlessly transliterate Arabic text from Egyptian Commercial Register into English. Our innovative product automates the process of converting names, addresses, and other textual data into a consistent transliterated version, ensuring accuracy and compatibility across different systems and languages.

## Transliteration (Arabic to English)

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

#### Headers

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

#### Request Body

| Name        | Type   | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| bundle\_key | string | A bundle key provided to you by Valify.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| json        | object | <p>Object containing at least one of the parameters below:<br><code>{</code> <br><code>"company\_type": \<str>,</code></p><p><code>"cr\_number": \<str>,</code></p><p><code>"cr\_unique\_number": \<str>,</code></p><p><code>"licensing\_authority": \<str>,</code></p><p><code>"company\_name": \<str>,</code></p><p><code>"company\_commercial\_name": \<str>,</code></p><p><code>"incorportation\_date":' \<str>,</code></p><p><code>"renewal\_date": \<str>,</code></p><p><code>"address": \<str>,</code></p><p><code>"owners": \<str>,</code></p><p><code>"capital": \<str>,</code></p><p><code>"paid\_in\_capital": \<str>,</code></p><p><code>"partners\_share\_value":\<str>,</code></p><p><code>"in\_kind\_shares\_value": \<str>,</code></p><p><code>"remaining\_capital\_pledged": \<str></code><br><code>}</code><br></p> |

**Status Codes**

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

```python
{
    'result': {
        "company_type": '<str>',
        "cr_number": '<str>',
        "cr_unique_number": '<str>',
        "licensing_authority": '<str>',
        "company_name": '<str>',        
        "company_commercial_name": '<str>',
        "incorporation_date": '<str>',
        "renewal_date": '<str>',
        "address": '<str>',
        "owners": '<list>',
        "capital": '<str>',
        "paid_in_capital": '<str>',
        "partners_share_value": '<str>',
        "in_kind_shares_value": '<str>',
        "remaining_capital_pledged": '<str>',
    },
    'transaction_id': '<str>',
    '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 %}

***

## Integration

{% tabs %}
{% tab title="🐍Python 3" %}

```python
import requests


token = "<token>"
data = {
        "company_type": <str>,
        "cr_number": <str>,
        "cr_unique_number": <str>,
        "licensing_authority": <str>,
        "company_name": <str>,
        "company_commercial_name": <str>,
        "incorportation_date":' <str>,
        "renewal_date": <str>,
        "address": <str>,
        "owners": <str>,
        "capital": <str>,
        "paid_in_capital": <str>,
        "partners_share_value":<str>,
        "in_kind_shares_value": <str>,
        "remaining_capital_pledged": <str>
    }
 

r = requests.post("https://<base-url>/api/v1/translate/egy-cr/",
        json=data,
        headers={'Authorization': 'Bearer %s' % token}
    )
print(r.json())                      
```

{% endtab %}
{% endtabs %}