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

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

List the specific causes of your stop catalog: the second level of a stop's classification,
under a general cause.

Which specific causes go under which general cause is set per loss tree, so it can differ
between machines; use `GET /v1/stops/classification-options` for a machine's combinations.

## `GET /v1/stops/specific-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 specific causes, by name

Type: array of object

- `id` (string (uuid), required, e.g. `"f89b5866-2d26-45a1-8cfc-8295557594d8"`) — The id of the specific cause.
- `name` (string, required, e.g. `"Bearing failure"`) — The name of the specific cause.
- `description` (string, optional, nullable) — The description of the specific cause.
- `externalName` (string, optional, nullable, e.g. `"MECH-BRG"`) — The name of the specific 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/specific-causes' \
  -H 'x-api-key: <YOUR_API_KEY>'
```