Get Translation

This endpoint retrieves the details of a translation request, including documents.

GET /v1/translation/{translation_id}

Request

--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": "[e-mail]",
      "phone": "[phone]"
    },
    "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"
  }
}

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_id · string · required

The unique identifier of the translation case to retrieve.
Example: 123e4567-e89b-12d3-a456-426614174000

Response

result · string

Indicates the outcome of the request.
Possible values: success or error

message · string

A human-readable summary of the result.
Example: Translation fetched successfully.

translation_id · string

The unique identifier for the translation case in a UUID format.
Example: 123e4567-e89b-12d3-a456-426614174000

status · string

The current status of the translation process.
Possible values: draft, pending, completed, archive, feedback-requested or refund-needed

translation_type · string

The service type.
Possible values: standard or certified

certification_jurisdiction · string

The 2-letter ISO country code of the country where the certified translation is valid.
Example: DE

source_language · string

The ISO code of the language the original document is written in.
Example: de

target_language · string

The ISO code of the language the document should be translated into.
Example: en

is_apostille_needed · boolean

Indicates if a legal apostille was requested for the translated documents.\

urgency · string

The priority level of the request.
Possible values: standard, priority or express

documents · array

List of documents associated with this case.

Show Document Object

id · string

Unique document UUID.
Example: 123e4567-e89b-12d3-a456-426614174001

type · string

The role of the document in the case.
Possible values: original or translation

name · string

The file name of the document.
Example: birth_certificate.pdf

pages · number

Number of pages in the document.
Example: 2

download_url · string

A 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_method · string

The selected delivery method for the final documents.
Possible values: email, postal or express

is_insurance_needed · boolean

Indicates if order insurance was applied to the request.

client_details · object

Information about the requesting client.

Show Client Details

first_name · string

The first name of the client.
Example: John

last_name · string

The last name of the client.
Example: Doe

email · string

The email address of the client.
Example: [e-mail]

phone · string

The phone number of the client.
Example: [phone]

delivery_address · object

The physical address where the documents will be shipped.

Show Address Object

person_type · string

The type of recipient.
Possible values: private or business \

first_name · string

The first name of the recipient.
Example: John

last_name · string

The last name of the recipient.
Example: Doe

business_name · string

The name of the company.
Example: Beglaubigt GmbH

street · string

The street name and house number.
Example: Hauptstraße 12

city · string

The city of the address.
Example: Berlin

zip · string

The postal code.
Example: 10115

country · string

The 2-letter ISO country code.
Example: DE

additional · string

Additional information like floor, suite, or apartment.
Example: Hinterhaus, 2. OG

billing_address · object

The address used for invoicing. Follows the same structure as delivery_address.

price · number

The total price of the translation in EUR.
Example: 85.50

url · string

Direct dashboard link to the case.
Example: https://app.beglaubigt.de/cases/123e4567-e89b-12d3-a456-426614174000

client_reference · string

The custom reference provided during request creation.
Example: PO-99821

client_preferred_language · string

The ISO code for notification preferences.
Possible values: de, en, fr, es or it

created_at · string

ISO 8601 timestamp of translation creation.
Example: 2026-02-07T14:21:30.000Z

Request

--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": "[e-mail]",
      "phone": "[phone]"
    },
    "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"
  }
}