---
title: "Get batch status"
method: GET
path: "/job-batches-api/v2/projects/{projectId}/batches/{batchUid}"
tags: ["Job Batches V2"]
---

# Get batch status

`GET /job-batches-api/v2/projects/{projectId}/batches/{batchUid}`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/job-batches-api/v2/projects/{projectId}/batches/{batchUid}`
- Auth: HTTP bearer

Returns batch status with detailed statuses of all batch items and their locales.

## Path parameters

- `projectId` string, required: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.
- `batchUid` string, required

## Response `200`

OK

- BatchStatusResponseV2: Batch info with detailed statuses of all batch items and their locales
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `status` 'DRAFT' | 'ADDING_FILES' | 'EXECUTING' | 'COMPLETED': The status of the Batch
      - `authorized` boolean: The flag showing if authorizing job is requested for this Batch
      - `generalErrors` string: Describes a list of errors which occurred while batch processing
      - `projectId` string: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.
      - `translationJobUid` string: Translation job unique identifier — 12 lowercase alphanumeric characters.
      - `updatedDate` string, date-time: ISO 8601 UTC timestamp.
      - `files` BatchItemV2[]: Array of files included in this batch with their processing status
        - `status` 'UPLOADING' | 'UPLOADED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED', required: Current status of the batch item
        - `updatedDate` string, date-time: ISO 8601 UTC timestamp.
        - `errors` string: JSON string containing error details if any occurred
        - `fileUri` string, required: URI path of a source file within a Smartling project.
        - `targetLocales` BatchItemLocaleV2DTO[], required: Array of target locales for this file
          - `localeId` string, required: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
          - `stringsAdded` integer, required: Number of strings added for this locale

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `404`: Batch provided in path is not found
- `500`: Unexpected error

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/job-batches-api/v2/projects/:projectId/batches/:batchUid/get.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)