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

# deel job

> Poll jobs with the Deel CLI

The `job` commands follow asynchronous operations by id and accept several job ids in one call. To paginate results, use the [`jobs`](/cli/reference/jobs) commands. See [Asynchronous jobs](/cli/usage/async-jobs) for the workflow.

| Command                               | Description                  |
| ------------------------------------- | ---------------------------- |
| [`deel job status`](#deel-job-status) | Fetch one or more jobs by id |
| [`deel job list`](#deel-job-list)     | List recent jobs             |

Both commands accept the [global options](/cli/reference/global-options).

## deel job status

Fetch the status and per-item results of one or more jobs.

**`Usage`**

```bash title="Usage"
deel job status <id>[,<id>...] [GLOBAL OPTIONS]
```

**Arguments**

| Argument | Required | Description                                |
| -------- | -------- | ------------------------------------------ |
| `id`     | Yes      | One job id, or several separated by commas |

**Response**

`data` is a single job object for one id, or an array of job objects for several ids, in the order given.

| Field                 | Type   | Description                                                            |
| --------------------- | ------ | ---------------------------------------------------------------------- |
| `job_id`              | string | The job identifier                                                     |
| `status`              | string | Derived from all items: `PENDING`, `RUNNING`, `SUCCEEDED`, or `FAILED` |
| `items`               | array  | One entry per item processed by the job                                |
| `items[].external_id` | string | The id you provided when submitting the item, when present             |
| `items[].status`      | string | Status of this item: `PENDING`, `RUNNING`, `SUCCEEDED`, or `FAILED`    |
| `items[].error`       | object | Error detail when this item failed, absent otherwise                   |

This is the same job data [`deel jobs status`](/cli/reference/jobs#deel-jobs-status) returns; `job status` additionally accepts several comma-separated ids.

**Errors**

| Code            | Cause                                   |
| --------------- | --------------------------------------- |
| `usage.job`     | No id was given                         |
| `job.not_found` | No job found for that id                |
| `job.error`     | The job lookup returned an error status |

**Examples**

```bash
deel job status 7f3c9b1e-2d84-4a51-9c07-1b5e8a0f3d62
deel job status 7f3c9b1e-2d84-4a51-9c07-1b5e8a0f3d62,9a10c2d4-8e35-4a92-b6f1-7c3d9e5a2b18 --fields job_id,status
deel jobs status --job_id=7f3c9b1e-2d84-4a51-9c07-1b5e8a0f3d62 --jq '.items[] | select(.status == "FAILED")'
```

## deel job list

List recent jobs for the authenticated account.

**`Usage`**

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

**Response** (`data` array)

| Field        | Type   | Description                                    |
| ------------ | ------ | ---------------------------------------------- |
| `job_id`     | string | The job identifier                             |
| `name`       | string | The operation that created the job             |
| `status`     | string | `PENDING`, `RUNNING`, `SUCCEEDED`, or `FAILED` |
| `created_at` | string | ISO 8601 creation timestamp                    |
| `created_by` | string | The user or token that created the job         |

**Example**

```bash
deel job list --jq '.[] | select(.status == "RUNNING") | .job_id' --raw
```

For pagination parameters (`--limit`, `--cursor`), use [`deel jobs list`](/cli/reference/jobs#deel-jobs-list).

> Build apps and integrations that extend and enhance the Deel services.