---
method: POST
path: /api/devices/claim/lookup
auth: jwt
area: devices
---
<!-- source: internal/handlers/devices.go DeviceHandler.LookupPairingCode -->

# Look Up Pairing Code

Resolve a pairing code to its pending registration WITHOUT binding it — the
data the Devices page confirm card shows ("Pair 'My Kindle Paperwhite'?").
Shares the per-account attempt budget with `POST /api/devices/claim`.

**Endpoint**: `POST /api/devices/claim/lookup`
**Auth**: JWT
**Content-Type**: `application/json`

## Request Body

| Field        | Type   | Required | Description                                  |
| ------------ | ------ | -------- | -------------------------------------------- |
| pairing_code | string | Yes      | The 6-digit code shown on the device's screen |

### Example Request

```json example-request
{
  "pairing_code": "583912"
}
```

## Response (200 OK)

```json example-response
{
  "device_name": "My Kindle Paperwhite",
  "device_type": "koreader",
  "device_identifier": "koreader-hostname",
  "expires_in": 245
}
```

## Error Responses

| Code | Description                                            |
| ---- | ------------------------------------------------------ |
| 400  | Invalid pairing code (generic — never confirms whether a registration exists) |
| 409  | Pairing code already used                              |
| 410  | Pairing code expired                                   |
| 429  | Too many pairing attempts                              |