Create Translation
This endpoint creates a translation request for one or multiple documents.
Authorization
To authenticate requests, include an Authorization header with a Bearer token:
Authorization: Bearer <token>
Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000
Body
translation_typestringrequiredThe type of translation service required. Use certified for officially recognized translations for authorities, or standard for professional business and private documents.
Possible values: standard or certified
certification_jurisdictionstringThe 2-letter ISO country code of the country where the certified translation will be used.
Example: DE
Note: Required if translation_type is certified.
source_languagestringrequiredThe ISO code of the language the original document is written in. Refer to the list of supported languages below.
Example: de
target_languagestringrequiredThe ISO code of the language the document should be translated into. Refer to the list of supported languages below.
Example: en
| Language | ISO | Language | ISO | Language | ISO |
|---|---|---|---|---|---|
| Afrikaans | af | Hebrew | he | Norwegian | no |
| Amharic | am | Hindi | hi | Punjabi | pa |
| Arabic | ar | Croatian | hr | Polish | pl |
| Azerbaijani | az | Haitian Creole | ht | Pashto/Pushto | ps |
| Belarusian | be | Hungarian | hu | Portuguese | pt-pt |
| Bulgarian | bg | Armenian | hy | Romanian | ro |
| Bengali/Bangla | bn | Indonesian | id | Moldavian | mo |
| Catalan | ca | Icelandic | is | Singhalese | si |
| Czech | cs | Italian | it | Slovak | sk |
| Russian | ru | Japanese | ja | Slovenian | sl |
| Danish | da | Georgian | ka | Somali | so |
| German | de | Khmer | km | Albanian | sq |
| Greek | el | Kannada | kn | Serbian | sr |
| English | en-gb | Korean | ko | Swedish | sv |
| Spanish | es | Kurdish | ku | Swahili | sw |
| Estonian | et | Latin | la | Tamil | ta |
| Finnish | fi | Lingala | ln | Thai | th |
| French | fr | Lithuanian | lt | Tigrinya | ti |
| Farsi | fy | Latvian/Lettish | lv | Tagalog | tl |
| Irish | ga | Maori | mi | Turkish | tr |
| Gujarati | gu | Macedonian | mk | Ukrainian | uk |
| Hausa | ha | Mongolian | mn | Urdu | ur |
| Marathi | mr | Malay | ms | Uzbek | uz |
| Vietnamese | vi | Yoruba | yo | Chinese (Simp) | zh-hans |
| Chinese (Trad) | zh-hant | Dari | fa-af | Maltese | mt |
| Burmese | my | Nepali | ne | Dutch | nl |
Warning: While we support a wide range of languages, certain specific language combinations are currently unavailable. Please review the Unsupported Language Pairs section below before submitting your request to avoid validation errors.
Requests for the following specific language combinations will return a 422 error:
| From (Source) | To (Target) | From (Source) | To (Target) |
|---|---|---|---|
Afrikaans (af) | German (de) | Dutch (nl) | German (de) |
Afrikaans (af) | English (en-gb) | French (fr) | Nepali (ne) |
Albanian (sq) | Lithuanian (lt) | Georgian (ka) | Lithuanian (lt) |
Albanian (sq) | Spanish (es) | Indonesian (id) | Spanish (es) |
Azerbaijani (az) | Dutch (nl) | Latvian (lv) | Dutch (nl) |
Azerbaijani (az) | English (en-gb) | Lithuanian (lt) | Croatian (hr) |
Bengali (bn) | German (de) | Malay (ms) | German (de) |
Bulgarian (bg) | Ukrainian (uk) | Marathi (mr) | French (fr) |
Burmese (my) | French (fr) | Marathi (mr) | German (de) |
Burmese (my) | German (de) | Polish (pl) | English (en-gb) |
Burmese (my) | Spanish (es) | Romanian (ro) | Indonesian (id) |
Dari (fa-af) | English (en-gb) |
urgencystringThe priority level of the request.
standard: 3-5 business days.
priority: ~48 hours.
urgent: ~24 hours.
Possible values: standard, priority or urgent
Default value: standard
is_apostille_neededbooleanIndicates if a legal apostille is required for the translated documents.
Default value: false
documentsarrayrequiredAn array of strings containing the URLs of the documents to be translated.
Example: ["https://example.com/doc1.pdf"]
delivery_methodstringHow the final translation should be delivered.
Possible values: email, postal or express
Default value: email
translator_notesstringAdditional instructions or notes for the translator (Max 191 characters).
Example: Please ignore the handwritten scribbles at the bottom of the page.
is_insurance_neededbooleanWhether to include insurance for the translation order.
Default value: false
client_detailsobjectrequiredInformation about the person requesting the translation.
first_namestringrequiredFirst name of the client.
Example: John
last_namestringrequiredLast name of the client.
Example: Doe
emailstringrequiredEmail address for communication and digital delivery.
Example: john.doe@example.com
phonestringrequiredContact phone number in international format.
Example: +4915222320123
delivery_addressobjectThe physical address for shipping.
Note: Required if delivery_method is postal or express.
person_typestringPossible values: private or business
Default value: private
first_namestringrequiredRecipient's first name.
Example: Max
last_namestringrequiredRecipient's last name.
Example: Mustermann
business_namestringName of the company (if applicable).
Example: Muster GmbH
streetstringrequiredStreet name and house number.
Example: Schillerstraße 15
citystringrequiredCity name.
Example: Berlin
zipstringrequiredPostal/Zip code.
Example: 10115
countrystringrequired2-letter ISO country code.
Example: DE
phonestringContact phone for delivery.
Example: +493012345678
additionalstringExtra details (e.g., Suite, Apartment, Floor).
Example: Hinterhaus, 2. OG
billing_addressobjectThe address to be used for the invoice. Uses the same structure as delivery_address.
client_referencestringA custom reference string for internal tracking.
Example: PO-99821
client_preferred_languagestringPreferred language for automated notifications.
Possible values: en, de, es, fr or it
Response
resultstringIndicates the outcome of the request.
Possible values: success or error
messagestringA human-readable summary of the result.
Example: Translation created successfully.
translation_idstringThe unique UUID identifying the created translation case.
Example: 8963cd77-b5f9-4280-986d-6137e9fea106
statusstringThe initial status of the translation.
Value: pending
urlstringThe dashboard URL to monitor the translation progress.
Example: https://app.beglaubigt.de/cases/123e4567-e89b-12d3-a456-426614174000
timestampstringThe ISO 8601 timestamp of when the case was created.
{
"translation_type": "certified",
"certification_jurisdiction": "DE",
"source_language": "de",
"target_language": "en",
"urgency": "priority",
"is_apostille_needed": true,
"translator_notes": "Please ensure the name 'Müller' is transliterated exactly as written.",
"documents": [
"https://example.com/my-document.pdf"
],
"delivery_method": "express",
"is_insurance_needed": false,
"client_details": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"phone": "+491701234567"
},
"delivery_address": {
"person_type": "private",
"first_name": "John",
"last_name": "Doe",
"street": "Hauptstraße 12",
"additional": "Hinterhaus, 2. OG",
"city": "Berlin",
"zip": "10115",
"country": "DE"
},
"client_reference": "MY_CLIENT_12345"
}{
"response": {
"result": "success",
"message": "Translation created successfully.",
"translation_id": "8963cd77-b5f9-4280-986d-6137e9fea106",
"status": "pending",
"url": "https://app.beglaubigt.de/cases/8963cd77-b5f9-4280-986d-6137e9fea106",
"timestamp": "2026-02-07T14:21:30.000Z",
"client_reference": "MY_CLIENT_12345"
}
}