# Listar causas gerais (https://docs.pulsarml.com/pt/v1/api-reference/stops/get-stops-general-causes)

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

Lista as causas gerais do seu catálogo de paragens: o primeiro nível da classificação de uma paragem, como `Mechanical failure` ou `Planned maintenance`.

Só são listadas as causas que podem ser colocadas numa árvore de perdas, porque só essas podem classificar uma paragem. Cada máquina aceita apenas as causas gerais da sua própria árvore de perdas; utilize `GET /v1/stops/classification-options` para ver o que uma máquina aceita.

## `GET /v1/stops/general-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 gerais ativas, por nome

Type: array of object

- `id` (string (uuid), required, e.g. `"d56aece5-a92a-462e-b275-919e15446bba"`) — O id da causa geral.
- `name` (string, required, e.g. `"Mechanical failure"`) — O nome da causa geral.
- `description` (string, optional, nullable) — A descrição da causa geral.
- `externalName` (string, optional, nullable, e.g. `"MECH"`) — O nome da causa geral 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/general-causes' \
  -H 'x-api-key: <YOUR_API_KEY>'
```