Jobs

List jobs within a project

Changed on Oct 17, 2026

List / search the jobs within a project. By default, only the last 50 jobs are returned. Use the <code>limit</code> and <code>offset</code> parameters to return more than 50 jobs. <a href="https://help.smartling.com/hc/en-us/articles/1260805176869-Pagination" target="_blank">Learn more.</a>

get/jobs-api/v3/projects/{projectId}/jobs

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

jobNamestring

Used for searching jobs by jobName. Any entry is treated as a LIKE query on the name of the job.

jobNumberstring

Used for searching jobs by jobNumber. Search works by exact comparison.

translationJobUidsTranslationJobUid[]

Used for searching jobs by translationJobUid. Supports up to 500 translationJobUids.

[
  "j45v1uvsi3tx"
]

translationJobStatusstring[]

Used for searching jobs by their status.

limitinteger

The limit on the number of jobs returned.

offsetinteger

The offset to use when searching for jobs.

sortBy'createdDate' | 'dueDate' | 'jobName'

The field to sort by.

sortDirection'ASC' | 'DESC'

The direction to sort.

Response

Example response

{
  "response": {
    "data": {
      "items": [
        {
          "createdDate": "2026-01-15T10:00:00Z",
          "dueDate": "2026-01-15T10:00:00Z",
          "jobNumber": "SMTL-123",
          "jobStatus": "DRAFT | AWAITING_AUTHORIZATION | IN_PROGRESS | COMPLETED | CANCELLED | CLOSED",
          "targetLocaleIds": [
            "fr-FR"
          ],
          "translationJobUid": "j45v1uvsi3tx",
          "referenceNumber": "CustomerReferenceNum1"
        }
      ]
    }
  }
}

Changes

Oct 17, 20262cd7a8215799 Revision changes
- breaking
  added the pattern ^[a-z0-9]{9}$ to the path request parameter projectId
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property /// became nullable for the status
- info
  the ////// response's property pattern ^[a-z]{2}(-[A-Z]{2})?$ was added for the status
- info
  the ///// response's property pattern ^[a-z0-9]{12}$ was added for the status
Aug 6, 2026ae422098d9c5 Revision changes
- warning
  removed the optional property ///// from the response with the status
- info
  added the new optional query request parameter jobNumber
- info
  added the enum value AWAITING_AUTHORIZATION to the property items/ of the query request parameter translationJobStatus
- info
  added the enum value CANCELLED to the property items/ of the query request parameter translationJobStatus
- info
  added the enum value CLOSED to the property items/ of the query request parameter translationJobStatus
- info
  added the enum value COMPLETED to the property items/ of the query request parameter translationJobStatus
- info
  added the enum value DELETED to the property items/ of the query request parameter translationJobStatus
- info
  added the enum value DRAFT to the property items/ of the query request parameter translationJobStatus
- info
  added the enum value IN_PROGRESS to the property items/ of the query request parameter translationJobStatus
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status

Operation history