SMsmartling
Job Batches V1

List batches

Changed on

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

get/jobs-batch-api/v1/projects/{projectId}/batches

Request

  • Base URL
    https://api.smartling.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

Example:84c012a33

A unique project identifier. This can be found in the Smartling Dashboard under Account Settings > API.

Query parameters

translationJobUidstring

Translation job unique identifier — 12 lowercase alphanumeric characters.

Example:j45v1uvsi3tx

A unique identifier for a translationJob.

status'DRAFT' | 'ADDING_FILES' | 'EXECUTING' | 'COMPLETED'

The status of the Batch

sortBy'createdDate' | 'status'

The field to sort by

orderBy'asc' | 'desc'

Sorting direction

offsetinteger

Number of items to skip. Default is 0.

limitinteger

Standard Smartling limit and offset to paginate through results. 20 batches are returned by default if not specified.

Response

OK

Example response

{
  "response": {
    "data": {
      "items": [
        {
          "translationJobUid": "j45v1uvsi3tx",
          "projectId": "84c012a33",
          "createdDate": "2026-01-15T10:00:00Z",
          "modifiedDate": "2026-01-15T10:00:00Z"
        }
      ]
    }
  }
}

Changes