---
title: "Get device allowlist status"
method: GET
path: "/api/v1/apps/{app_id}/device-allowlist"
tags: ["Apps"]
---

# Get device allowlist status

`GET /api/v1/apps/{app_id}/device-allowlist`

Returns the device_id allowlist status for an app's CVMs. For on-chain KMS apps, queries the blockchain in real-time to check which devices are registered in the app contract.

## Path parameters

- `app_id` string, required — Hex app identifier

## Response `200`

Device allowlist status

- DeviceAllowlistResponse
  - `is_onchain_kms` boolean
  - `allow_any_device` boolean, nullable
  - `chain_id` integer, nullable
  - `app_contract_address` string, nullable
  - `devices` DeviceAllowlistItem[]
    - `device_id` string, required
    - `node_name` string, nullable
    - `cvm_ids` integer[]
    - `allowed_onchain` boolean
    - `status` string, required

## Other responses

- `401` — Not authenticated
- `404` — App not found or not on-chain KMS
- `422` — Validation Error

---

[API](https://skmtc.dev/phala/apis/phala-cloud-api.md) · [All operations](https://skmtc.dev/phala/apis/phala-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phala/phala-cloud-api/revisions/83c6ae62e860/schema)