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

# Listar dispositivos de kiosco

> Lee los dispositivos de kiosco del comercio, con estado, tienda y salud de la app.

Devuelve los dispositivos de kiosco del comercio autenticado. Es el mismo conjunto que muestra la página de dispositivos de kiosco en el dashboard.

> [!NOTE]
>
> Requiere un access token con el scope `kiosk:read`. Consulta
> [Token](https://firespark.cloud/docs/es/integrations-api/oauth/token/post.md) para obtener un token.

## Request

```bash theme={null}
curl "https://firespark.cloud/api/integrations/v1/kiosk/devices?channel_id=kioscos" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Query parameters

| Parámetro | Tipo | Descripción |
| - | - | - |
| `channel_id` | string | Filtra por canal de kiosco. Identificador externo del canal. Si se omite, se devuelven todos los dispositivos no eliminados del comercio. |

## Response

`data` es un arreglo de dispositivos, del más reciente al más antiguo. Cada dispositivo incluye el código de emparejamiento, el código de la tablet, los ids de tienda y canal, el estado, la salud, el software y los campos derivados del dashboard: `app_presence`, `app_update_status`, `is_online` y `can_operate`.

| Campo | Descripción |
| - | - |
| `status` | `PENDING`, `LINKED`, `ENROLLED`, `DISABLED` o `UNLINKED`. Un dispositivo creado por esta API empieza en `LINKED`. |
| `pairing_code` | Código de seis caracteres generado al crear el dispositivo. |
| `device_code` | Código que muestra la tablet. Se guarda en mayúsculas. |
| `settings_overrides.disabled_payment_ids` | Ids de configuración de pago apagados en este dispositivo. |
| `health` | Batería, carga, almacenamiento, red y estado de la app reportados por la tablet. |
| `software` | Versión de Android y de la app reportadas por la tablet. |
| `app_presence` | `FOREGROUND`, `BACKGROUND`, `CLOSED` o `UNKNOWN`. |
| `app_update_status` | `CURRENT`, `OUTDATED`, `UPDATING`, `FAILED` o `UNKNOWN`. |
| `is_online` | Si la tablet se reportó hace poco. |
| `can_operate` | Si el dispositivo puede tomar pedidos. |

```json Success theme={null}
{
  "data": [
    {
      "id": "counter-1",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "merchant_id": "a3f3ee84-ddc6-44aa-8f86-d2e9270dcdec",
      "channel_id": "kioscos",
      "channel_uid": "b1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "store_id": "downtown",
      "store_uid": "c1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "alias": "Counter 1",
      "pairing_code": "K7M2QX",
      "device_code": "TABLET01",
      "settings_overrides": { "disabled_payment_ids": [] },
      "status": "LINKED",
      "last_seen_at": "2026-09-25T16:00:00.000Z",
      "health": { "battery_pct": 82, "charging": true, "app_state": "active" },
      "software": { "app_version_name": "1.4.0", "app_version_code": 140 },
      "app_track_ids": [],
      "app_update_status": "CURRENT",
      "can_operate": true,
      "is_online": true,
      "app_presence": "FOREGROUND"
    }
  ]
}
```


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