---
title: "List Runs Queue"
method: GET
path: "/runs-queue"
tags: ["runs"]
---

# List Runs Queue

`GET /runs-queue`

This endpoint lists Runs Queue on allowed scopes.

## Query parameters

- `page[number]` string
- `page[size]` string
- `include` string[]
- `filter[workspace]` string
- `filter[account]` string
- `filter[environment]` string
- `filter[run]` string
- `filter[status]` string
- `filter[source]` string
- `filter[vcs-revision]` string
- `filter[created-by]` string
- `filter[created-by-run]` string
- `filter[env-or-ws]` string
- `filter[created-at]` string
- `query` string
- `filter[is-dry]` string
- `scheduled` string
- `filter[tag]` string
- `filter[resource-drifts]` string
- `fields` object
  - `applies` string — The comma-separated list of fields to return in response for Apply resource.
  - `configuration-versions` string — The comma-separated list of fields to return in response for ConfigurationVersion resource.
  - `cost-estimates` string — The comma-separated list of fields to return in response for CostEstimate resource.
  - `environments` string — The comma-separated list of fields to return in response for Environment resource.
  - `plans` string — The comma-separated list of fields to return in response for Plan resource.
  - `policy-checks` string — The comma-separated list of fields to return in response for PolicyCheck resource.
  - `runs` string — The comma-separated list of fields to return in response for Run resource.
  - `status-transitions` string — The comma-separated list of fields to return in response for StatusTransition resource.
  - `tags` string — The comma-separated list of fields to return in response for Tag resource.
  - `users` string — The comma-separated list of fields to return in response for User resource.
  - `vcs-revisions` string — The comma-separated list of fields to return in response for VcsRevision resource.
  - `workspaces` string — The comma-separated list of fields to return in response for Workspace resource.

## Response `200`

Success.

## Other responses

- `404` — User unauthorized to perform action.
- `4XX` — Client error.
- `5XX` — Server error.

---

[API](https://skmtc.net/scalr/apis/scalr-iacp-api.md) · [All operations](https://skmtc.net/scalr/apis/scalr-iacp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalr/scalr-iacp-api/versions/fc927526ad12/schema)