Get Translation
This endpoint retrieves the details of a translation request, including documents.
Authorization
To authenticate requests, include an Authorization header with a Bearer token:
Authorization: Bearer <token>
Example: Bearer sk-123e4567-e89b-12d3-a456-426614174000
Path Parameters
translation_idstringrequiredThe unique identifier of the translation case to retrieve.
Example: 123e4567-e89b-12d3-a456-426614174000
Response
resultstringIndicates the outcome of the request.
Possible values: success or error
messagestringA human-readable summary of the result.
Example: Translation fetched successfully.
translation_idstringThe unique identifier for the translation case in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000
statusstringThe current status of the translation process.
Possible values: draft, pending, completed, archive, feedback-requested or refund-needed
translation_typestringThe service type.
Possible values: standard or certified
certification_jurisdictionstringThe 2-letter ISO country code of the country where the certified translation is valid.
Example: DE
source_languagestringThe ISO code of the language the original document is written in.
Example: de
target_languagestringThe ISO code of the language the document should be translated into.
Example: en
is_apostille_neededbooleanIndicates if a legal apostille was requested for the translated documents.\
urgencystringThe priority level of the request.
Possible values: standard, priority or express
documentsarrayList of documents associated with this case.
idstringUnique document UUID.
Example: 123e4567-e89b-12d3-a456-426614174001
typestringThe role of the document in the case.
Possible values: original or translation
namestringThe file name of the document.
Example: birth_certificate.pdf
pagesnumberNumber of pages in the document.
Example: 2
download_urlstringA temporary signed URL to download the PDF. Valid for 24 hours.
Example: https://app.beglaubigt.de/download?bucket=translation-documents&id=123e4567-e89b-12d3-a456-426614174000&token=a1H...To5
delivery_methodstringThe selected delivery method for the final documents.
Possible values: email, postal or express
is_insurance_neededbooleanIndicates if order insurance was applied to the request.
client_detailsobjectInformation about the requesting client.
first_namestringThe first name of the client.
Example: John
last_namestringThe last name of the client.
Example: Doe
emailstringThe email address of the client.
Example: john.doe@example.com
phonestringThe phone number of the client.
Example: +491701234567
delivery_addressobjectThe physical address where the documents will be shipped.
person_typestringThe type of recipient.
Possible values: private or business \
first_namestringThe first name of the recipient.
Example: John
last_namestringThe last name of the recipient.
Example: Doe
business_namestringThe name of the company.
Example: Beglaubigt GmbH
streetstringThe street name and house number.
Example: Hauptstraße 12
citystringThe city of the address.
Example: Berlin
zipstringThe postal code.
Example: 10115
countrystringThe 2-letter ISO country code.
Example: DE
additionalstringAdditional information like floor, suite, or apartment.
Example: Hinterhaus, 2. OG
billing_addressobjectThe address used for invoicing. Follows the same structure as delivery_address.
pricenumberThe total price of the translation in EUR.
Example: 85.50
urlstringDirect dashboard link to the case.
Example: https://app.beglaubigt.de/cases/123e4567-e89b-12d3-a456-426614174000
client_referencestringThe custom reference provided during request creation.
Example: PO-99821
client_preferred_languagestringThe ISO code for notification preferences.
Possible values: de, en, fr, es or it
created_atstringISO 8601 timestamp of translation creation.
Example: 2026-02-07T14:21:30.000Z
--request GET 'https://api.beglaubigt.de/v1/translation/123e4567-e89b-12d3-a456-426614174000' \
--header 'Authorization: Bearer <token>'{
"response": {
"result": "success",
"message": "Translation fetched successfully.",
"translation_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"translation_type": "certified",
"certification_jurisdiction": "DE",
"source_language": "de",
"target_language": "en",
"is_apostille_needed": true,
"urgency": "priority",
"documents": [
{
"id": "123e4567-e89b-12d3-a456-426614174001",
"type": "original",
"name": "birth_certificate.pdf",
"pages": 2,
"download_url": "https://app.beglaubigt.de/download?bucket=translation-documents&id=123e4567-e89b-12d3-a456-426614174001&token=a1H...To5"
}
],
"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"
},
"billing_address": {
"person_type": "private",
"first_name": "John",
"last_name": "Doe",
"street": "Hauptstraße 12",
"city": "Berlin",
"zip": "10115",
"country": "DE"
},
"price": 85.50,
"url": "[https://app.beglaubigt.de/cases/123e4567-e89b-12d3-a456-42661417400]",
"client_reference": "PO-99821",
"client_preferred_language": "de",
"created_at": "2026-02-07T14:21:30.000Z"
}
}