API overview

The Translate By Humans API allows you to connect your application to Translate By Humans and directly employ our services instead of going through our order form.

Since translation is done by humans and is not an automated process, our API is asynchronous. This means that you have to allow time for the translators to finish translation.

Supported Industries

Having spent a substantial time in streamlining the accredited document translation services as well as having dealt with a global clientele, Translate By Humans proudly stands in as an industry leader. We can translate text from all industries, common being finance, legal, medical, technical, public sector, etc.

Supported Files

  1. Documents
    .doc, .docx, .odt .txt .rtf  .xls, .xlsx .pdf, .pptx
  2. Software
    .strings .xml .json .po .pot .yml .ymal .plist .stringsdict .xliff .resx
  3. Mobile
    .xml .strings

Placing your order

We have streamlined the process of placing new translation orders using our API. You simply have to make a POST request to our API with the following fields in your request to be able to place a new order:
source_language_code,destination_language_code,category_id,source_text,proof_reading &Upload file
To know more about how to obtain the above mentioned parameters, click here.

Before an order can be placed, the developer needs to set up a callback URL so as to receive proper notifications regarding the order status change. Data will be submitted through POST method in callback URL. Read more about setting callback URL.

Check the status of your order

Each submitted job goes through a series of statuses before delivery. To help you better understand the progress made by your order, we let you check the status of the order. For a complete list of order statuses, read this.

Get your translation back

Translate By Humans will send the completed jobs to your system as translators complete them. However, if you’d like to retrieve order details for a specific order id you can do so by invoking the order detail API.

To get a complete list of orders placed and their details, use the orders API.

Cancellation of Order and Credit Refund

We currently do not support this feature in our API. For an order cancellation and/or credit refund, please contact the project manager.

Response format

We return all API data in JSON format. All API responses consist for 4 keys-

  1. data: Depending on the request, this key will contain the returned output.
  2. message: This contains a suitable message for your request. In case an error occurs, this key will contain the description of the error.
  3. error_code: When an error occurs, this key will contain the error code which you can check against our list of error codes to recognize what went wrong. To get a complete list of error codes, read this.
  4. success: this key returns a boolean value (true/false).

Text Encoding and Language Codes

We use UTF-8 text encoding.

We recommend that you use sourcelanguage and destinationlanguage API for language selection so as to be sure that translation is supported for your choice of language.

Language Code
Afrikaans
af
Albanian
sq
Arabic
ar
Armenian
hy
Bulgarian
bg
Catalan
ca
Chinese-Simplified
zh_CN
Chinese-Traditional
zh_TW
Croatian
hr
Czech
cs
Danish
da
Dutch
nl
English
en
English-United Kingdom
en_GB
English-United States
en_US
Estonian
et
Finnish
fi
French
fr
French-Canada
fr_CA
French-France
fr_FR
German
de
Greek
el
Hebrew
he
Hindi
hi
Hungarian
hu
Italian
it
Japanese
ja
Korean
ko
Malay
ms
Norwegian
no
Polish
pl
Portuguese
pt
Portuguese-Brazil
pt_BR
Portuguese-Portugal
pt_PT
Romanian
ro
Russian
ru
Slovak
sk
Slovenian
sl
Spanish
es
Spanish-Latin America
es_LA
Spanish-Spain
es_ES
Spanish-Mexico
es_LA_MX
Swedish
sv
Tagalog
tl
Thai
th
Turkish
tr
Ukrainian
uk
Urdu
ur
Vietnamese
vi
Welsh
cy
© 2018 Translate By Humans [Innovative Humans Limited]. All Rights Reserved.