---
title: "List jobs"
description: "List every job this workspace has run, of every kind, through one envelope."
url: https://docs.roasos.com/api-reference/jobs/listJobs
---

# List jobs

List every job this workspace has run, of every kind, through one envelope.

## `GET /v1/jobs`

Endpoint: `GET https://api.roasos.com/v1/jobs`

List jobs

List every job this workspace has run, of every kind, through one envelope.

### Parameters

- `kind` (query): Filter by job kind.
- `status` (query): Filter by job status.
- `undefined`
- `undefined`

### Responses

- `200`: One page of job envelopes
- `400`: Invalid kind, status, or cursor

Read the full reference at https://docs.roasos.com/api-reference/jobs/listJobs.