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

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

List the general causes of your stop catalog: the top level of a stop's classification, such as
`Mechanical failure` or `Planned maintenance`.

Only the causes that can be placed in a loss tree are listed, since only those can classify a
stop. Each machine accepts only the general causes of its own loss tree; use
`GET /v1/stops/classification-options` for what a given machine accepts.

## `GET /v1/stops/general-causes`

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 general causes, by name

Type: array of object

- `id` (string (uuid), required, e.g. `"d56aece5-a92a-462e-b275-919e15446bba"`) — The id of the general cause.
- `name` (string, required, e.g. `"Mechanical failure"`) — The name of the general cause.
- `description` (string, optional, nullable) — The description of the general cause.
- `externalName` (string, optional, nullable, e.g. `"MECH"`) — The name of the general cause in your own system, when one was set.

#### 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/general-causes' \
  -H 'x-api-key: <YOUR_API_KEY>'
```