---
title: "Translate a document"
method: POST
path: "/translate/v1/document"
tags: ["Translation"]
---

# Translate a document

`POST /translate/v1/document`

## Request

- Base URL: `https://api.case.dev`
- URL: `https://api.case.dev/translate/v1/document`
- Auth: HTTP bearer

Translate one TXT, DOCX, or searchable PDF document. DOCX and PDF translations preserve the source document format and retain as much layout and formatting as possible.

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: TXT, DOCX, or searchable PDF document (max 20MB)
  - `target` string, required: Target BCP-47 language code
  - `source` string: Optional source BCP-47 language code. Auto-detected when omitted.

## Response `200`

Translated document in the source file format

## Other responses

- `400`: Invalid request or unsupported file type
- `401`: Invalid API key
- `403`: API key does not have translation access
- `413`: File exceeds the 20MB limit

## Changes

- **2026-10-16** `a21d188f4b21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casemark/apis/case-dev-api/changes/translate/v1/document/post.md)

---

[API](https://skmtc.dev/casemark/apis/case-dev-api.md) - [All operations](https://skmtc.dev/casemark/apis/case-dev-api/llms.txt) - [OpenAPI document](https://skmtc.dev/casemark/apis/case-dev-api/revisions/9a3245c00044?raw)