# Listar causas específicas (https://docs.pulsarml.com/pt/v1/api-reference/stops/get-stops-specific-causes)

**Scope necessário:** `stop_catalogs.read`.

Lista as causas específicas do seu catálogo de paragens: o segundo nível da classificação de uma paragem, abaixo de uma causa geral.

As causas específicas que ficam abaixo de cada causa geral são definidas em cada árvore de perdas, por isso podem variar de máquina para máquina; utilize `GET /v1/stops/classification-options` para ver as combinações de uma máquina.

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

Base URLs:
- `https://draco.prod.pulsarml.com` — Produção
- `https://draco.stage.pulsarml.com` — Sandbox (staging)

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

### Responses

#### 200 — As suas causas específicas ativas, por nome

Type: array of object

- `id` (string (uuid), required, e.g. `"f89b5866-2d26-45a1-8cfc-8295557594d8"`) — O id da causa específica.
- `name` (string, required, e.g. `"Bearing failure"`) — O nome da causa específica.
- `description` (string, optional, nullable) — A descrição da causa específica.
- `externalName` (string, optional, nullable, e.g. `"MECH-BRG"`) — O nome da causa específica no seu próprio sistema, quando foi definido.

#### 401 — * `unauthenticated`: as credenciais estão em falta, são inválidas ou expiraram.

#### 403 — * `missing_scope`: as credenciais são válidas, mas não têm o scope que este endpoint requer.

#### 429 — * `rate_limited`: a chave de API excedeu o seu limite de pedidos. Tente novamente após `Retry-After` segundos.

### Example request

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