Listar dispositivos de kiosco - Fire spark

{
  "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"
    }
  ]
}

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

Requiere un access token con el scope kiosk:read. Consulta Token para obtener un token.

Request

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.

{
  "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"
    }
  ]
}