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

**Scope requerido:** `stop_catalogs.read`.

Lista las causas generales de tu catálogo de paros: el primer nivel de la clasificación de un paro, como `Mechanical failure` o `Planned maintenance`.

Solo se listan las causas que se pueden colocar en un árbol de pérdidas, porque solo esas pueden clasificar un paro. Cada máquina acepta únicamente las causas generales de su propio árbol de pérdidas; usa `GET /v1/stops/classification-options` para ver lo que acepta una máquina.

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

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

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

### Responses

#### 200 — Tus causas generales activas, por nombre

Type: array of object

- `id` (string (uuid), required, e.g. `"d56aece5-a92a-462e-b275-919e15446bba"`) — El id de la causa general.
- `name` (string, required, e.g. `"Mechanical failure"`) — El nombre de la causa general.
- `description` (string, optional, nullable) — La descripción de la causa general.
- `externalName` (string, optional, nullable, e.g. `"MECH"`) — El nombre de la causa general en tu propio sistema, si se definió uno.

#### 401 — * `unauthenticated`: Las credenciales faltan, no son válidas o expiraron.

#### 403 — * `missing_scope`: Las credenciales son válidas, pero no tienen el scope que requiere este endpoint.

#### 429 — * `rate_limited`: La API key superó su límite de solicitudes. Reintenta después de `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>'
```