# List stop components (https://docs.pulsarml.com/v1/api-reference/stops/get-stops-components)

**Required scope:** `stop_catalogs.read`.

List the components of your stop catalog: the part of a machine a stop is attributed to.

Components are assigned to machines; use `GET /v1/stops/classification-options` for the
components of a given machine.

## `GET /v1/stops/components`

Base URLs:
- `https://draco.prod.pulsarml.com` — Production
- `https://draco.stage.pulsarml.com` — Sandbox (staging)

Authentication: send your API key in the `x-api-key` header.

### Responses

#### 200 — Your active components, by name

Type: array of object

- `id` (string (uuid), required, e.g. `"3e8e81cf-7521-4ef9-b6c9-40074aa764c5"`) — The id of the component.
- `name` (string, required, e.g. `"Main motor"`) — The name of the component.
- `description` (string, optional, nullable) — The description of the component.

#### 401 — * `unauthenticated`: The credentials are missing, invalid or expired.

#### 403 — * `missing_scope`: The credentials are valid but lack the scope this endpoint requires.

#### 429 — * `rate_limited`: The API key exceeded its rate limit. Retry after `Retry-After` seconds.

### Example request

```bash
curl -X GET 'https://draco.prod.pulsarml.com/v1/stops/components' \
  -H 'x-api-key: <YOUR_API_KEY>'
```