---
title: "Returns the status for a specific document"
method: GET
path: "/document/batches/{id}/documents/{documentId}"
---

# Returns the status for a specific document

`GET /document/batches/{id}/documents/{documentId}`

Returns the translation status for a specific document based on the request Id
and document Id.

## Path parameters

- `id` string, uuid, required
- `documentId` string, uuid, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- DocumentStatus — Document Status Response
  - `path` string — Location of the document or folder
  - `sourcePath` string, required — Location of the source document
  - `createdDateTimeUtc` string, date-time, required — Operation created date time
  - `lastActionDateTimeUtc` string, date-time, required — Date time in which the operation's status has been updated
  - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' | 'Cancelled' | 'Cancelling' | 'ValidationFailed', required — List of possible statuses for job or document
  - `to` string, required — To language
  - `error` TranslationError — This contains an outer error with error code, message, details, target and an inner error with more descriptive details.
    - `code` 'InvalidRequest' | 'InvalidArgument' | 'InternalServerError' | 'ServiceUnavailable' | 'ResourceNotFound' | 'Unauthorized' | 'RequestRateTooHigh', required — Enums containing high level error codes.
    - `message` string, required — Gets high level error message.
    - `target` string — Gets the source of the error. For example it would be "documents" or "document id" in case of invalid document.
    - `innerError` InnerTranslationError — New Inner Error format which conforms to Cognitive Services API Guidelines which is available at https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. This contains required properties ErrorCode, message and optional properties target, details(key value pair), inner error(this can be nested).
      - `code` string, required — Gets code error string.
      - `message` string, required — Gets high level error message.
      - `target` string — Gets the source of the error. For example it would be "documents" or "document id" in case of invalid document.
      - `innerError` InnerTranslationError — recursive
  - `progress` number, float, required — Progress of the translation if available
  - `id` string, uuid, required — Universally Unique Identifier
  - `characterCharged` integer — Character charged by the API
  - `totalImageScansSucceeded` integer — Total image scans charged by the API
  - `totalImageScansFailed` integer — Total image scans failed
  - `imageCharged` integer — Images charged by the API
  - `imageCharacterDetected` integer — Characters detected within images

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01-preview) `2a29f2b714b8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/translation-documenttranslation/changes/document/batches/:id/documents/:documentId/get.md)

---

[API](https://skmtc.dev/azure/apis/translation-documenttranslation.md) · [All operations](https://skmtc.dev/azure/apis/translation-documenttranslation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/translation-documenttranslation/revisions/f29cf344b9da/schema)