SMsmartling
Jobs

List jobs within an account

Changed on

List / search the jobs within an account. 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/accounts/{accountUid}/jobs

Request

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

Path parameters

accountUidstring required

A unique account 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.

projectIdsProjectUid[]

Used for searching jobs by projectId. Supports up to 500 projectIds.

[
  "84c012a33"
]
translationJobStatusstring[]

Used for searching jobs by their status.

withPriorityboolean

If set to true, returns jobs only with priority.

limitinteger

The limit on the number of jobs returned.

offsetinteger

The offset to use when searching for jobs.

sortBy'createdDate' | 'priority'

The field to sort by.

sortDirection'ASC' | 'DESC'

The direction to sort.

Response

OK

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 | DELETED",
          "priority": 2,
          "projectId": "84c012a33",
          "referenceNumber": "CustomerReferenceNum1",
          "targetLocaleIds": [
            "fr-FR"
          ],
          "translationJobUid": "j45v1uvsi3tx"
        }
      ]
    }
  }
}

Changes

  • 2cd7a8215799Revision changes
    • 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

    • breaking

      the ///// response's property type changed from string to no type for status

    • info

      added to the ///// response property allOf list for the response 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

  • ae422098d9c5Revision changes
    • info

      endpoint added