---
method: GET
path: /api/sync/koreader/library
auth: device-token
area: koreader
---
<!-- source: internal/handlers/koreader.go:1391 KOReaderHandler.GetLibrary -->

# Get Library

Get library metadata for KOReader device.

**Endpoint**: `GET /api/sync/koreader/library`
**Auth**: Required (Device authentication)

## Device Authentication

This endpoint requires device authentication (not user JWT). Devices authenticate using their device credentials.

## Request Headers

| Header       | Type   | Required | Description               |
| ------------ | ------ | -------- | ------------------------- |
| X-Device-ID  | string | Yes      | Device UUID               |
| X-Device-Key | string | Yes      | Device authentication key |

### Example Request

```http
GET /api/sync/koreader/library
X-Device-ID: 550e8400-e29b-41d4-a716-446655440000
X-Device-Key: device-auth-key
```

## Response (200 OK)

```json example-response
{
  "last_sync": null,
  "library_sync": null,
  "total_books": null
}
```

## Error Responses

| Code | Description                  |
| ---- | ---------------------------- |
| 401  | Device authentication failed |
| 404  | Device not found             |