> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar terminais de uma loja

> Lista os caixas POS, quiosques e telas de cozinha registrados em uma loja, com o status atual.

Retorna os terminais registrados em uma loja: caixas **POS**, **quiosques** de autoatendimento e
telas de cozinha **KDS**. Por padrão, retorna o que a loja tem habilitado hoje, ou seja, terminais
ativos e suspensos. Os revogados só vêm se você pedir com `status`.

Se a loja não existir ou pertencer a outro tenant, a resposta é `404` (nunca se revela se ela
existe em outro tenant).

## Autenticação

**x-api-key** `string` *required*

Sua API key do Fire com o scope `store:read`. A key **deve estar vinculada a um vendor**. Keys
sem `vendorId` são rejeitadas com `403`.

## Path params

**storeId** `string` *required*

UUID da loja (`stores.id`).

## Query params

**type** `string`

Tipos de terminal separados por vírgula: `POS`, `KIOSK`, `KDS`. Se omitido, retorna os três.

**status** `string` (default: ACTIVE,SUSPENDED)

Status separados por vírgula: `ACTIVE`, `SUSPENDED`, `REVOKED`.

**fields** `string`

Lista de campos a retornar, separados por vírgula (projection). Veja
[Projeção de campos](https://docs.fire.rest/pt/api-reference/list-stores.md#projecao-de-campos). Se omitido, retorna
todos os campos.

## Requisição

```http theme={null}
GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000/terminals?type=KIOSK,POS
x-api-key: <your_api_key>
```

## Resposta

**terminals** `object[]`

**terminal**

**id** `string`

UUID do terminal.

**storeId** `string`

UUID da loja.

**name** `string`

Nome exibido do terminal.

**type** `string`

`POS`, `KIOSK` ou `KDS`.

**status** `string`

`ACTIVE` operando, `SUSPENDED` pausado por um administrador, `REVOKED` desativado.

**externalId** `string | null`

Identificador externo do equipamento. Em quiosques, o device ID exibido na tela QR. `null` em POS e KDS.

**lastSeenAt** `string | null`

Última vez que o terminal se comunicou com o Fire (ISO 8601). `null` se nunca se conectou.

**createdAt** `string`

Quando o terminal foi registrado (ISO 8601).

**total** `number`

Quantidade de terminais retornados.

```json 200 theme={null}
{
  "terminals": [
    {
      "id": "8d0f6b1e-3c2a-4f57-9a61-0e2d4b7c9a10",
      "storeId": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Caixa 1",
      "type": "POS",
      "status": "ACTIVE",
      "externalId": null,
      "lastSeenAt": "2026-10-06T15:02:11Z",
      "createdAt": "2026-09-01T10:00:00Z"
    },
    {
      "id": "2b7e4a90-61d3-4c0e-8f2b-7a5c1d9e3f44",
      "storeId": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Quiosque Entrada",
      "type": "KIOSK",
      "status": "ACTIVE",
      "externalId": "K082-94",
      "lastSeenAt": "2026-10-06T14:58:40Z",
      "createdAt": "2026-09-03T12:30:00Z"
    }
  ],
  "total": 2
}
```

```json 400 — status desconhecido theme={null}
{
  "success": false,
  "error": "VALIDATION_ERROR",
  "message": "Datos de entrada inválidos",
  "details": [
    { "code": "custom", "path": ["status"], "message": "Invalid status: BROKEN. Allowed: ACTIVE, SUSPENDED, REVOKED" }
  ]
}
```

```json 404 — não existe ou é de outro tenant theme={null}
{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}
```

## Relacionado

> **[Obter loja](https://docs.fire.rest/pt/api-reference/get-store.md)**
>
> Leia a configuração completa da loja.

> **[Administração de terminais](https://docs.fire.rest/pt/manuals/pos/terminal-admin.md)**
>
> Suspenda, reative ou revogue terminais pelo backoffice.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.