Skip to main content
POST
/
v1
/
translation
{
  "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://beglaubigt.de/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
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_type
string
required
The 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_jurisdiction
string
The 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_language
string
required
The ISO code of the language the original document is written in. Refer to the list of supported languages below.
Example: de
​
target_language
string
required
The ISO code of the language the document should be translated into. Refer to the list of supported languages below.
Example: en
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.
​
urgency
string
The 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_needed
boolean
Indicates if a legal apostille is required for the translated documents.
Default value: false
​
documents
array
required
An array of strings containing the URLs of the documents to be translated.
Example: ["https://example.com/doc1.pdf"]
​
delivery_method
string
How the final translation should be delivered.
Possible values: email, postal or express
Default value: email
​
translator_notes
string
Additional instructions or notes for the translator (Max 191 characters).
Example: Please ignore the handwritten scribbles at the bottom of the page.
​
is_insurance_needed
boolean
Whether to include insurance for the translation order.
Default value: false
​
client_details
object
required
Information about the person requesting the translation.
​
delivery_address
object
The physical address for shipping.
Note: Required if delivery_method is postal or express.
​
billing_address
object
The address to be used for the invoice. Uses the same structure as delivery_address.
​
client_reference
string
A custom reference string for internal tracking.
Example: PO-99821
​
client_preferred_language
string
Preferred language for automated notifications.
Possible values: en, de, es, fr or it

​
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 created successfully.
​
translation_id
string
The unique UUID identifying the created translation case.
Example: 8963cd77-b5f9-4280-986d-6137e9fea106
​
status
string
The initial status of the translation.
Value: pending
​
url
string
The dashboard URL to monitor the translation progress.
Example: https://app.beglaubigt.de/cases/123e4567-e89b-12d3-a456-426614174000
​
timestamp
string
The 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"
  }
}