# list_runs

Recent runs, newest first.

Recent runs, newest first.

| | |
|---|---|
| REST operation | [`listRuns`](/reference/rest/runs/#listruns) (`GET /v1/runs`) |
| Needs a device | no |
| Read only | yes |
| Profiles | `testing`, `full` |

## Parameters

| Name | Required | Type | Goes to | What it is |
|---|---|---|---|---|
| `status` | no | `queued`, `binding`, `running`, `passed`, `failed`, `errored`, `cancelled` | query `status` |  |
| `limit` | no | integer | query `limit` |  |

## Example call

```text
list_runs({})
```