---
title: "List jobs"
method: GET
path: "/jobs"
tags: ["Jobs"]
---

# List jobs

`GET /jobs`

## Request

- Base URL: `https://api.togai.com`
- URL: `https://api.togai.com/jobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/togaihq/apis/togai-apis/docs/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of jobs with pagination and sort.

## Query parameters

- `nextToken` string
- `pageSize` number

## Response `200`

Response for list customers request

- JobsPaginatedResponse
  - `data` JobsWithoutStatusInfoResponse[]
    - `id` string, required
    - `type` string, required
    - `status` string, required
    - `updatedAt` string, date-time, required
  - `nextToken` string
  - `context` PaginationOptions
    - `pageSize` integer
    - `sortOrder` 'ASC' | 'DESC'

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response
- `429`: Error response
- `default`: Error response

## Changes

- **2024-03-11** `cc0b10fb537e`: 1 info
  - endpoint added
- **2023-09-02** `6b13f6f47735`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/togaihq/apis/togai-apis/changes/jobs/get.md)

---

[API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [All operations](https://skmtc.dev/togaihq/apis/togai-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/togaihq/apis/togai-apis/revisions/442f5d8f4aa0?raw)