Doctranslate.io Translation API
  • Introduction
    • Welcome to Doctranslate.io
    • What is DocTranslate.io
    • User Manual
  • Document Translation API
    • System requirement
    • Upload API
      • Upload multiple files and calculate usage cost
    • User API
      • User History
    • Translation API
      • API V1
        • Document Translation
        • Translate Multiple Files (currently supports document, video)
        • Image Translation
        • Audio Translation
        • Text Translation
        • Get result
      • API V2
        • Document Translation
        • Translate Multiple Files (currently supports document, video)
        • Image Translation
        • Audio Translation
        • Text Translation
        • Get result
      • API V3
        • Document Translation
        • Translate Multiple Files (currently supports document, video)
        • Audio Translation
        • Text Translation
        • Get result
    • Presentation Maker API
      • API V1
        • Presentation Maker
        • Presentation Maker For Multiple Files
      • API V2
        • Presentation Maker
        • Presentation Maker For Multiple Files
  • Presentation Video API
    • API V1
      • Create transcripts presentation
      • Update transcripts presentation
      • Create video presentation
      • Get result
    • API V2
      • Create transcripts presentation
      • Update transcripts presentation
      • Create video presentation
      • Get result
  • Others
    • Code examples
      • API V1
        • Upload Multiple Files
        • Translate Multiple Document Files
        • Text Translation
        • Document Translation
        • Image Translation
        • Audio Translation
        • Video Translation
        • Presentation Maker
        • Presentation Video
      • API V2
        • Upload Multiple Files
        • Translate Multiple Document Files
        • Text Translation
        • Document Translation
        • Image Translation
        • Audio Translation
        • Video Translation
        • Presentation Maker
        • Presentation Video
    • Support
Powered by GitBook
On this page
  1. Document Translation API
  2. Translation API
  3. API V2

Get result

Get result translate by task id

HTTP request

GET /v1/result/{task_id}

Authorization

OAuth2PasswordBearer

Authorization: OAuth2PasswordBearer

Path Parameters

KEY
TYPE
VALUE

task_id

String

Provided when calling translation API.

Response

200: Success

Response schema: application/json

KEY
VALUE

status_code

200

content

{ "data": { "7be10528f259430381daa6885bbb11a9": { "task_id": "7be10528f259430381daa6885bbb11a9", "url_download": "https://media.doctranslate.io/doctranslator-production/output/docx/test_truyen_16_en_1747902169.docx?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=qa0e1UFJ0Trmajw8ttCM%2F20250522%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250522T084129Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=b51064047dcc20dbf4bb237df6345d9d8148ac46cee071b852a480461edc84a1", "type": "document", "status": "done", "file_name": "test_truyen_16_en_1747902169.docx", "filename": null, "cost": 0.54, "dest_lang": "en", "translation_type": "Document", "datetime": "2025-05-22 15:41:29.098340" }, "status": null }, "errors": [], "error_description": "", "start_time": "2025-05-22 15:41:31.451406", "end_time": "2025-05-22 15:41:31.451933", "status": "success" }

task_id (data/task_id)

Unique identifier for the translation task.

url_download (data/url_download)

URL to download the translated file.

type (data/type)

Type of translation.

status (data/status )

Current status of the task (e.g., done, processing, failed).

file_name (data/file_name )

The name of the translated output file, including the file extension (e.g., .docx, .pdf, .srt). This is the actual filename users will download.

filename (data/filename )

The name of the translated output file, including the file extension (e.g., .docx, .pdf, .srt). This is the actual filename users will download.

cost (data/cost )

Credit or cost consumed for the translation task.

dest_lang (data/dest_lang )

Destination language code (e.g., en, ja, vi).

translation_type (data/translation_type )

Type of translation service used.

start_time

The timestamp when the translation task started, in Vietnam time (UTC+7, Asia/Ho_Chi_Minh).

end_time

The timestamp when the translation task started, in Vietnam time (UTC+7, Asia/Ho_Chi_Minh).

400: Bad Request Response schema: application/json

KEY
VALUE

status_code

400

content

{ "data": { "status": "failed", "task_id": "7be10528f259430381daa6885bbb11a9", "success": false, "type": "fail_task", "cost": 0, "file_name": "test_truyen_16_1747902169.docx", "filename": "test_truyen_16_1747902169.docx", "dest_lang": "en", "translation_type": "Document", "datetime": "2025-05-22 15:23:14.637752" }, "errors": [], "error_description": "", "start_time": "2025-05-22 15:52:06.087026", "end_time": "2025-05-22 15:52:06.087519", "status": "success" }

task_id

Unique identifier for the translation task.

status (data/status )

Current status of the task (e.g., done, processing, failed).

type (data/type)

Type of translation.

cost (data/cost )

Credit or cost consumed for the translation task.

file_name (data/file_name )

The name of the translated output file, including the file extension (e.g., .docx, .pdf, .srt). This is the actual filename users will download.

filename (data/filename )

The name of the translated output file, including the file extension (e.g., .docx, .pdf, .srt). This is the actual filename users will download.

dest_lang (data/dest_lang )

Destination language code (e.g., en, ja, vi).

translation_type (data/translation_type )

Type of translation service used.

start_time

The timestamp when the translation task started, in Vietnam time (UTC+7, Asia/Ho_Chi_Minh).

end_time

The timestamp when the translation task started, in Vietnam time (UTC+7, Asia/Ho_Chi_Minh).

401: Authentication Error

Response schema: application/json

KEY
VALUE

status_code

401

content

{ "detail": "Not authenticated" }

PreviousText TranslationNextAPI V3

Last updated 17 days ago