---
title: "List jobs within a project"
method: GET
path: "/jobs-api/v3/projects/{projectId}/jobs"
tags: ["Jobs"]
---

# List jobs within a project

`GET /jobs-api/v3/projects/{projectId}/jobs`

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>

## Path parameters

- `projectId` string, required

## Query parameters

- `jobName` string
- `jobNumber` string
- `translationJobUids` string[]
- `translationJobStatus` string[]
- `limit` integer
- `offset` integer
- `sortBy` 'createdDate' | 'dueDate' | 'jobName'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

OK

- ListJobsResponse
  - `response` object, required
    - `code` 'SUCCESS', required — Indicates whether the response was successful or what error has occured.
    - `data` object, required
      - `items` ListJobsResponseItem[]
        - `createdDate` string, date-time — The UTC value of the date the job was created.
        - `description` string — The description of the job.
        - `dueDate` string, date-time — The UTC value of the due date for the job.
        - `jobName` string — The name of the job.
        - `jobNumber` string — The account level unique number of the job. Consist of unique short prefix and sequence number.
        - `jobStatus` string — The status of the job
        - `targetLocaleIds` string[] — The array of localeIds for the job.
        - `translationJobUid` string — The unique identifier of the job.
        - `referenceNumber` string — Customer specific number/identifier for the job.
      - `totalCount` number

## Other responses

- `400` — Provided request parameters are invalid.
- `401` — Provided credentials are not valid.
- `429` — Too many simultaneous API requests.
- `500` — Unexpected error

---

[API](https://skmtc.net/smartling/apis/smartling-rest-api-reference.md) · [All operations](https://skmtc.net/smartling/apis/smartling-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartling/smartling-rest-api-reference/revisions/2a73d11e9b98/schema)