> This page is for CLI.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.

# deel jobs

> Command reference for the jobs group of the Deel CLI

The **Operation** column shows the Deel API operation each command calls; the command requires the same token scopes as that operation. Request fields are validated before a request is sent.

| Command                                 | Operation            | Description    |
| --------------------------------------- | -------------------- | -------------- |
| [`deel jobs list`](#deel-jobs-list)     | `GET /jobs`          | List jobs      |
| [`deel jobs status`](#deel-jobs-status) | `GET /jobs/{job_id}` | Retrieve a job |

All commands accept the [global options](/cli/reference/global-options). Run `deel <command> --help --json` to output the contract as JSON.

## deel jobs list

List jobs.

Calls `GET /jobs`.

**`Usage`**

```bash title="Usage"
deel jobs list [GLOBAL OPTIONS]
```

#### Options

| Option     | In    | Type    | Required | Description                                                                |
| ---------- | ----- | ------- | -------- | -------------------------------------------------------------------------- |
| `--cursor` | query | string  | No       | Cursor for keyset pagination, taken from a previous response `page.cursor` |
| `--limit`  | query | integer | No       | Page size                                                                  |

#### Response

The envelope `data` is an array of objects with the following fields.

| Field        | Type   | Description                                                                                   |
| ------------ | ------ | --------------------------------------------------------------------------------------------- |
| `name`       | string | Name of the operation.                                                                        |
| `job_id`     | string | Identifier of the operation, identical to the job\_id returned when it was submitted.         |
| `status`     | string | Overall status of the operation. Allowed values: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`. |
| `created_at` | string | When the operation was submitted.                                                             |
| `created_by` | string | Identifier of the user or service that submitted the operation.                               |

#### Example

```bash
deel jobs list
```

#### Example output

```json
{
  "data": [
    {
      "name": "invoice-adjustment",
      "job_id": "7f3c9b1e-2d84-4a51-9c07-1b5e8a0f3d62",
      "status": "PENDING",
      "created_at": "2026-09-01",
      "created_by": "usr_01H8X3K9"
    }
  ],
  "meta": {
    "request_id": "3f1c9a52-7b04-4e1a-9a8c-2d5f8e1b0c77"
  }
}
```

## deel jobs status

Retrieve a job.

Calls `GET /jobs/{job_id}`.

**`Usage`**

```bash title="Usage"
deel jobs status [GLOBAL OPTIONS] --job_id=<string>
```

#### Options

| Option     | In   | Type   | Required | Description    |
| ---------- | ---- | ------ | -------- | -------------- |
| `--job_id` | path | string | Yes      | Job identifier |

#### Response

The envelope `data` is an object with the following fields.

| Field                 | Type   | Description                                                                                                           |
| --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------- |
| `items`               | array  | One entry per item processed by the operation.                                                                        |
| `items[].error`       | object | Error detail when this item failed, absent otherwise.                                                                 |
| `items[].status`      | string | Status of this item. Allowed values: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`.                                     |
| `items[].external_id` | string | The client-supplied id you provided when submitting the item.                                                         |
| `job_id`              | string | Identifier of the job returned when the operation was submitted.                                                      |
| `status`              | string | Overall status of the operation, derived from all items. Allowed values: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`. |

#### Example

```bash
deel jobs status --job_id=7f3c9b1e-2d84-4a51-9c07-1b5e8a0f3d62
```

#### Example output

```json
{
  "data": {
    "items": [
      {
        "status": "PENDING",
        "external_id": "payroll-2026-09-0001"
      }
    ],
    "job_id": "7f3c9b1e-2d84-4a51-9c07-1b5e8a0f3d62",
    "status": "PENDING"
  },
  "meta": {
    "request_id": "3f1c9a52-7b04-4e1a-9a8c-2d5f8e1b0c77"
  }
}
```