# List registered devices for the authenticated identity

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**GET** `/devices`

Base URL: `https://{host}`

Returns one bounded page of device registrations for the authenticated user, sorted by
`updated_at` descending. FCM tokens are truncated for security (last 10
characters prefixed with "...").

## Authorization

- x-bsv-auth-identity-key (apiKey in header)

## Query parameters

- `limit` (integer)
- `offset` (integer)

## Responses

### 200

Device list retrieved successfully.

- `status` ("success", required)
- `limit` (integer, required)
- `offset` (integer, required)
- `devices` (object[], required)
  - `id` (integer)
    Database row ID.
  - `deviceId` (string)
    Caller-supplied device identifier.
  - `platform` ("ios" | "android" | "web" | null)
  - `fcmToken` (string)
    Truncated FCM token (last 10 chars preceded by "...") for security.
  - `active` (boolean)
  - `createdAt` (string<date-time>)
  - `updatedAt` (string<date-time>)
  - `lastUsed` (string<date-time>)

Example:

```json
{
  "status": "success",
  "limit": 0,
  "offset": 0,
  "devices": [
    {
      "id": 0,
      "deviceId": "string",
      "platform": "ios",
      "fcmToken": "string",
      "active": true,
      "createdAt": "1970-01-01T00:00:00.000Z",
      "updatedAt": "1970-01-01T00:00:00.000Z",
      "lastUsed": "1970-01-01T00:00:00.000Z"
    }
  ]
}
```

### 401

Authentication required (`ERR_AUTHENTICATION_REQUIRED`).

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```

### 500

Internal server error (`ERR_DATABASE_ERROR`, `ERR_INTERNAL`).

- `status` ("error", required)
- `code` (string, required)
  Machine-readable error code (see specs/errors.md).
- `description` (string, required)
  Human-readable explanation.

Example:

```json
{
  "status": "error",
  "code": "string",
  "description": "string"
}
```