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

# List jobs

GET https://platform.labric.co/api/v1/jobs

List the organization's jobs, newest first.

Pass name to look up one job, since job names are unique within an
organization; the list is then empty or holds that job. Archived jobs
are left out unless archived is true.

Requires an API key with the `read` scope.

Reference: https://docs.labric.co/api-reference/labric-api/jobs/list

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `name` (string, optional, nullable)
- `archived` (boolean, optional, default: false)

## Response

### 200

OK

- `list of object`
  - `id` (string, required) — Pass this as job_id to the job execution tools.
  - `name` (string, required)
  - `archived` (boolean, required)
  - `description` (string, optional, nullable)

## Errors

### 400 Bad Request Error

Bad Request

- `detail` (string, required)

### 401 Unauthorized Error

Unauthorized

- `detail` (string, required)

### 403 Forbidden Error

Forbidden

- `detail` (string, required)

### 404 Not Found Error

Not Found

- `detail` (string, required)

### 422 Unprocessable Entity Error

Unprocessable Content

- `detail` (list of map from string to any, required)

### 500 Internal Server Error

Internal Server Error

- `detail` (string, required)

## Examples

**Response**

```json
[
  {
    "id": "string",
    "name": "string",
    "archived": true,
    "description": "string"
  }
]
```

**SDK Code**

```python
from labric import Labric

client = Labric(
    api_key="YOUR_TOKEN_HERE",
)

client.jobs.list()

```