Get status for a specific translation job

Reference
Feature: Azure AI Translator → Document Translation
API Version: 2024-05-01
HTTP method: GET

• Use the get translation status method to request the status of a specific translation job. The response includes the overall job status and the status for documents that are being translated as part of that job.

curl -i -X GET "{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}"

Request parameters passed on the query string are:

You can find the job id in the POST start-batch-translation method response Header Operation-Location URL value. The alphanumeric string following the /document/ parameter is the operation's job id:

• You can also use a get-translations-status request to retrieve a list of translation jobs and their ids.

Request headers are:

The following are the possible HTTP status codes that a request returns.

The following information is returned in a successful response.

The following JSON object is an example of a successful response.

{
  "id": "727bf148-f327-47a0-9481-abae6362f11e",
  "createdDateTimeUtc": "2020-03-26T00:00:00Z",
  "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
  "status": "Succeeded",
  "summary": {
    "total": 10,
    "failed": 1,
    "success": 9,
    "inProgress": 0,
    "notYetStarted": 0,
    "cancelled": 0,
    "totalCharacterCharged": 0
  }
}

The following JSON object is an example of an error response. The schema for other error codes is the same.

Status code: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "User is not authorized",
    "target": "Document",
    "innerError": {
      "code": "Unauthorized",
      "message": "Operation is not authorized"
    }
  }
}

Follow our quickstart to learn more about using Document Translation and the client library.