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)

POST 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	Object containing at least one of the parameters below: { "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> }

200 Success

{
    '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>'
}

400 Missing input data

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

401 Invalid bundle key

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

403 Access token error

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

404 Check the endpoint

{
    "message": "Not Found"
}

415 The format should be base64

{
    "message": "Unsupported Media Type"
}

422 Check Valify error codes

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

500 Contact us

{
    "message": "Internal Server Error"
}

---

Integration

Python 3

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())