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

# Get kiosk device

> Read one kiosk device by its external identifier.

Returns one kiosk device for the authenticated merchant.

> [!NOTE]
>
> Requires an access token with the `kiosk:read` scope. See
> [Token](https://firespark.cloud/docs/integrations-api/oauth/token/post.md) to obtain a token.

## Request

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

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `id` | string | External device identifier. Alphanumeric characters, `_`, and `-` only. 1–64 characters. |

## Response

The response wraps the device in `data`. Fields match [List kiosk devices](https://firespark.cloud/docs/integrations-api/kiosk/devices/get.md).

A missing device returns `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.