# Listar componentes (https://docs.pulsarml.com/pt/v1/api-reference/stops/get-stops-components)

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

Lista os componentes do seu catálogo de paragens: a parte de uma máquina à qual é atribuída uma paragem.

Os componentes são atribuídos às máquinas; utilize `GET /v1/stops/classification-options` para ver os componentes de uma máquina.

## `GET /v1/stops/components`

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 — Os seus componentes ativos, por nome

Type: array of object

- `id` (string (uuid), required, e.g. `"3e8e81cf-7521-4ef9-b6c9-40074aa764c5"`) — O id do componente.
- `name` (string, required, e.g. `"Main motor"`) — O nome do componente.
- `description` (string, optional, nullable) — A descrição do componente.

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