---
title: "Get an ensemble by name"
method: GET
path: "/ensembles/{em-name}"
tags: ["Ensemble"]
---

# Get an ensemble by name

`GET /ensembles/{em-name}`

Returns a specific ensemble.

## Response `200`

Success

- Ensemble
  - `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

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `404` — Resource not found
- `default` — Internal server error

## Changes

- **2021-01-12** `c4d83189c07b` — 2 info
  - api tag `Ensemble` added
  - added the new optional `query` request parameter `pretty-print` to all path's operations
- **2021-01-11** `c605463405d9` — 1 info
  - api tag `Ensemble` removed

[Change history](https://skmtc.dev/pegasus-isi/apis/ensemble-manager-api/changes/ensembles/:em-name/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)