---
title: "Get batch status"
method: GET
path: "/jobs-batch-api/v1/projects/{projectId}/batches/{batchUid}"
tags: ["Job Batches V1"]
---

# Get batch status

`GET /jobs-batch-api/v1/projects/{projectId}/batches/{batchUid}`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/jobs-batch-api/v1/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

- BatchStatusResponseV1: 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` BatchItemV1[]
        - `errors` string: A list of errors occurred while uploading or attaching file linked to this batchItem
        - `fileUri` string: URI path of a source file within a Smartling project.
        - `status` 'DRAFT' | 'UPLOADING' | 'UPLOAD_FAILED' | 'ATTACHING' | 'ATTACH_FAILED' | 'COMPLETED' | 'CANCELED': The status of the BatchItem
        - `targetLocales` BatchItemLocaleV1[]: Array of target locales where this file will be translated
          - `localeId` string: 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: Number of strings added to the translationJob from this file
          - `stringsSkipped` integer: Number of strings not added to the translationJob from this file
        - `updatedDate` string, date-time: ISO 8601 UTC timestamp.

## 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
- **2026-08-06** `ae422098d9c5`: 1 breaking
  - api removed without deprecation

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/jobs-batch-api/v1/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)