Skip to main content
POST
/
v2
/
document
curl --request POST \
  --url https://api.deepl.com/v2/document \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form target_lang=DE \
  --form file=@example-file
{
  "document_id": "04DE5AD98A02647D83285A36021911C6",
  "document_key": "0CB0054F1C132C1625B392EADDA41CB754A742822F6877173029A6C487E7F60A"
}

Authorizations

​
Authorization
string
header
required

Body

multipart/form-data
​
target_lang
enum<string>
required
Available options:
AR,
BG,
CS,
DA,
DE,
EL,
EN-GB,
EN-US,
ES,
ES-419,
ET,
FI,
FR,
HE,
HU,
ID,
IT,
JA,
KO,
LT,
LV,
NB,
NL,
PL,
PT-BR,
PT-PT,
RO,
RU,
SK,
SL,
SV,
TH,
TR,
UK,
VI,
ZH,
ZH-HANS,
ZH-HANT
Example:
​
file
file
required
​
source_lang
enum<string>
Available options:
AR,
BG,
CS,
DA,
DE,
EL,
EN,
ES,
ET,
FI,
FR,
HE,
HU,
ID,
IT,
JA,
KO,
LT,
LV,
NB,
NL,
PL,
PT,
RO,
RU,
SK,
SL,
SV,
TH,
TR,
UK,
VI,
ZH
Example:
​
filename
string
​
output_format
string
​
formality
enum<string>
default:default
Available options:
default,
more,
less,
prefer_more,
prefer_less
Example:
​
glossary_id
string
Example:
​
enable_beta_languages
boolean
default:false

Response

​
document_id
string
Example:
​
document_key
string
Example: