---
method: GET
path: /api/devices/pending
auth: jwt
area: devices
---
<!-- source: internal/handlers/devices.go DeviceHandler.ListPendingRegistrations -->

# List Pending Device Registrations

Always empty by design. Unclaimed device registrations are invisible to every
account since pairing codes took over the approval flow: first-approve-wins on
a broadcast list let any account claim (or reject) a device it could not even
name. Instead, the registering device shows a 6-digit pairing code, and the
person holding the device types it into their own account's Devices page —
`POST /api/devices/claim`.

**Endpoint**: `GET /api/devices/pending`
**Auth**: Required (JWT)

### Example Request

```http
GET /api/devices/pending
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```

## Response (200 OK)

```json example-response
{
  "registrations": [],
  "pending_registrations": [],
  "total": 0
}
```

Both `registrations` and `pending_registrations` key spellings are emitted for
API compatibility.

## Related

- [Register Device](register_device.md) — mints the pairing code
- [Claim Device](claim_device.md) — the code-driven replacement for list-and-approve