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

# List batches

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

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/jobs-batch-api/v1/projects/{projectId}/batches`
- Auth: HTTP bearer

List existing batches for the project, filtered by the given criteria.

## Path parameters

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

## Query parameters

- `translationJobUid` string: Translation job unique identifier — 12 lowercase alphanumeric characters.
- `status` 'DRAFT' | 'ADDING_FILES' | 'EXECUTING' | 'COMPLETED': The status of the Batch
- `sortBy` 'createdDate' | 'status'
- `orderBy` 'asc' | 'desc'
- `offset` integer
- `limit` integer

## Response `200`

OK

- ListBatchesResponse: A list of found, filtered and sorted batches
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `items` Batch[]
        - `batchUid` string: A unique identifier for a batch.
        - `status` 'DRAFT' | 'ADDING_FILES' | 'EXECUTING' | 'COMPLETED': The status of the Batch
        - `authorized` boolean: The flag showing if authorizing job is requested for this Batch
        - `translationJobUid` string: Translation job unique identifier — 12 lowercase alphanumeric characters.
        - `projectId` string: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.
        - `createdDate` string, date-time: ISO 8601 UTC timestamp.
        - `modifiedDate` string, date-time: ISO 8601 UTC timestamp.
        - `hasError` boolean: The flag showing if any error occurred during batch processing
      - `totalCount` integer: number of batches in the current rsponse

## Other responses

- `400`: Provided request parameters are invalid.
- `401`: Provided credentials are not valid.
- `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/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)