---
title: "List pre-assigned devices"
method: GET
path: "/v1/device-preassignments"
tags: ["device-preassignments"]
---

# List pre-assigned devices

`GET /v1/device-preassignments`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/device-preassignments`
- Auth: HTTP bearer

List devices pre-assigned to locations in your workspace. Each entry shows the end of the device serial number, the location, the screen name, and whether the device is still waiting to be claimed or has already been claimed. Results are limited to the organization nodes you can see.

**Notes.**
- Carries `available` beside `data`.

## Response `200`

Success.

- object
  - `data` object[], required
    - `id` string, required
    - `serialHint` string, nullable, required: The last 4 characters of the serial. The full serial is not stored.
    - `nodeId` string, required
    - `locationName` string, nullable, required
    - `locationId` string, nullable, required: The location's own id (its Location ID), when set.
    - `name` string, nullable, required
    - `status` 'waiting' | 'claimed', required
    - `claimedAt` string, nullable, required: ISO-8601 timestamp (UTC).
    - `claimedScreenId` string, nullable, required
    - `createdAt` string, required: ISO-8601 timestamp (UTC).
  - `available` boolean, required: False when the workspace's data region does not support pre-assignment yet (`data` is then empty).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)