# List your jobs

Scope `read`. Every started job on the key's page, newest first. Keys not attached to a board share one page per workspace.

## Endpoint

`GET /v1/api/jobs`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| limit | query | integer | No |

- **limit:** 1–200, default 50.
| before | query | string (date-time) | No |

- **before:** The previous page's `nextBefore` (RFC 3339).

## Responses

### 200

A page of jobs.

Content type: `application/json`.

```json
{
  "data": [
    {
      "id": "",
      "jobId": "",
      "status": "string",
      "state": "awaiting_start",
      "requestedAt": "2026-01-01T00:00:00Z",
      "finishedAt": "2026-01-01T00:00:00Z"
    }
  ],
  "nextBefore": "string"
}
```

### 400

`limit` or `before` is out of range.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 401

No key, or an unknown or revoked one.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 402

A key issued from Settings → Developer, on a workspace without the Enterprise plan.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 403

The key was not given `read`, or is a board key.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 404

No job or deal with that id that this key can reach.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```
