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"
}
}POSTCreate Translation
This endpoint creates a translation request for one or multiple documents.
POSTOverview
Submit a company's details to start its tax registration. An ELSTER XML document will be generated and sent the tax office, which reviews and files the registration. If ELSTER rejects it for any reason, one of our managers handles it and resends it.