> ## 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 terminales de una tienda

> Lista las cajas POS, los kioscos y las pantallas de cocina registrados en una tienda, con su estado actual.

Devuelve las terminales registradas en una tienda: cajas **POS**, **kioscos** de autoservicio y
pantallas de cocina **KDS**. Por defecto devuelve lo que la tienda tiene habilitado hoy, es decir,
las terminales activas y suspendidas. Las revocadas solo vienen si las pides con `status`.

Si la tienda no existe o pertenece a otro tenant, la respuesta es `404` (nunca se revela si existe
en otro tenant).

## Autenticación

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

Tu API key de Fire con el scope `store:read`. La key **debe estar asociada a un vendor**. Las
keys sin `vendorId` se rechazan con `403`.

## Path params

**storeId** `string` *required*

UUID de la tienda (`stores.id`).

## Query params

**type** `string`

Tipos de terminal separados por coma: `POS`, `KIOSK`, `KDS`. Si lo omites, devuelve los tres.

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

Estados separados por coma: `ACTIVE`, `SUSPENDED`, `REVOKED`.

**fields** `string`

Lista de campos a devolver, separados por coma (projection). Ver
[Projection de campos](https://docs.fire.rest/es/api-reference/list-stores.md#projection-de-campos). Si lo omites, devuelve
todos los campos.

## Petición

```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>
```

## Respuesta

**terminals** `object[]`

**terminal**

**id** `string`

UUID de la terminal.

**storeId** `string`

UUID de la tienda.

**name** `string`

Nombre visible de la terminal.

**type** `string`

`POS`, `KIOSK` o `KDS`.

**status** `string`

`ACTIVE` operando, `SUSPENDED` pausada por un administrador, `REVOKED` dada de baja.

**externalId** `string | null`

Identificador externo del equipo. En kioscos, el device ID que muestra la pantalla QR. `null` en POS y KDS.

**lastSeenAt** `string | null`

Última vez que la terminal se comunicó con Fire (ISO 8601). `null` si nunca se conectó.

**createdAt** `string`

Cuándo se registró la terminal (ISO 8601).

**total** `number`

Cantidad de terminales devueltas.

```json 200 theme={null}
{
  "terminals": [
    {
      "id": "8d0f6b1e-3c2a-4f57-9a61-0e2d4b7c9a10",
      "storeId": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Caja 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": "Kiosco Entrada",
      "type": "KIOSK",
      "status": "ACTIVE",
      "externalId": "K082-94",
      "lastSeenAt": "2026-10-06T14:58:40Z",
      "createdAt": "2026-09-03T12:30:00Z"
    }
  ],
  "total": 2
}
```

```json 400 — estado desconocido 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 — no existe o es de otro tenant theme={null}
{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}
```

## Relacionado

> **[Obtener tienda](https://docs.fire.rest/es/api-reference/get-store.md)**
>
> Lee la configuración completa de la tienda.

> **[Administración de terminales](https://docs.fire.rest/es/manuals/pos/terminal-admin.md)**
>
> Suspende, reactiva o revoca terminales desde el backoffice.


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