> ## 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.

# Obtener dispositivo de kiosco

> Lee un dispositivo de kiosco por su identificador externo.

Devuelve un dispositivo de kiosco del comercio autenticado.

> [!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/counter-1" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Path parameters

| Parámetro | Tipo | Descripción |
| - | - | - |
| `id` | string | Identificador externo del dispositivo. Solo caracteres alfanuméricos, `_` y `-`. De 1 a 64 caracteres. |

## Response

La respuesta envuelve el dispositivo en `data`. Los campos coinciden con [Listar dispositivos de kiosco](https://firespark.cloud/docs/es/integrations-api/kiosk/devices/get.md).

Un dispositivo inexistente responde `404`.

```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": ["cash-desk"] },
    "status": "ENROLLED",
    "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.