---
title: "List all ensembles"
method: GET
path: "/ensembles"
tags: ["Ensemble"]
---

# List all ensembles

`GET /ensembles`

Returns a list of all ensembles.

## Query parameters

- `query` string
- `order` string
- `start-index` integer
- `max-results` integer

## Response `200`

Success

- object
  - `records` Ensemble[], required
    - `id` integer, required
    - `name` string, required
    - `created` string, date-time, required
    - `updated` string, date-time, required
    - `state` 'ACTIVE' | 'HELD' | 'PAUSED', required
    - `max_running` integer, required
    - `max_planning` integer, required
  - `total` integer, required
  - `filtered` integer, required

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `default` — Internal server error

## Changes

- **2021-01-12** `c4d83189c07b` — 7 info
  - api tag `Ensemble` added
  - added the new optional `query` request parameter `pretty-print` to all path's operations
  - added the new optional `query` request parameter `max-results`
  - added the new optional `query` request parameter `order`
  - …3 more
- **2021-01-11** `c605463405d9` — 4 warning, 2 info
  - deleted the `query` request parameter `max-results`
  - deleted the `query` request parameter `order`
  - deleted the `query` request parameter `query`
  - deleted the `query` request parameter `start-index`
  - …2 more

[Change history](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api/changes/ensembles/get.md)

---

[API](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api.md) · [All operations](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pegasus-isi/ensemble-manager-api/revisions/bc40e50a342a/schema)