# Listar máquinas (https://docs.pulsarml.com/pt/v1/api-reference/machines/get-machines)

Devolve todas as máquinas que a empresa de quem faz a chamada pode ver.

As máquinas são o ponto de entrada para o resto da API. Os sinais usam o `uuid` devolvido aqui; os registos de produção, as velocidades nominais, o tempo real e os relatórios ainda usam o `id` inteiro. `uuid` é o identificador público estável da máquina; é nulo para as máquinas que ainda não têm um, e essas não podem ser consultadas para obter sinais. A lista não tem paginação nem filtros: está limitada à empresa que corresponde à credencial, por isso não há nenhum parâmetro de empresa a passar.

## `GET /v1/machines`

Base URLs:
- `https://draco.prod.pulsarml.com` — Produção
- `https://draco.dev.pulsarml.com` — Desenvolvimento (sandbox)

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

### Responses

#### 200 — Todas as máquinas que a empresa autenticada pode ver

Type: array of object

- `id` (integer, required, e.g. `1`) — O identificador único da máquina.
- `uuid` (string (uuid), required, nullable, e.g. `"01748f7c-9688-7abc-8def-0123456789ab"`) — O identificador público estável da máquina. É nulo para as máquinas que ainda não têm um.
- `name` (string, required, e.g. `"machine 1"`) — O nome da máquina.
- `externalName` (string, optional, nullable, e.g. `"EXT-1"`) — O nome externo da máquina, se tiver.
- `isActive` (boolean, required, e.g. `true`) — Se a máquina está ativa neste momento.
- `isCountEnabled` (boolean, required, e.g. `true`) — Se a contagem está ativada para a máquina.

### Example request

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