# Books

Book metadata, series, authors, and reading progress

## Endpoints

### GET /api/v1/books

List all books with optional search filters

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `isbn` | query | No | Filter by ISBN |
| `author` | query | No | Filter by author |
| `series` | query | No | Filter by series |
| `publisher` | query | No | Filter by publisher |
| `language` | query | No | Filter by language |
| `offset` | query | No | Pagination offset |
| `limit` | query | No | Pagination limit |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | List of books |
| 401 | Unauthorized |
| 500 | Internal server error |

---

### GET /api/v1/books/authors

List all authors with book counts

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `offset` | query | No | Pagination offset |
| `limit` | query | No | Pagination limit |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Authors with book counts |
| 401 | Unauthorized |

---

### GET /api/v1/books/authors/{name}/books

Get books by a specific author

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `name` | path | Yes | Author name |
| `offset` | query | No | Pagination offset |
| `limit` | query | No | Pagination limit |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Books by author |
| 401 | Unauthorized |

---

### GET /api/v1/books/reading-list

Get user's reading list

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `status` | query | No | Filter by reading status |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Reading list |
| 401 | Unauthorized |

---

### GET /api/v1/books/series

List all series with book counts

**Authentication:** Required (Bearer JWT)

#### Responses

| Status | Description |
|--------|-------------|
| 200 | List of series with counts |
| 401 | Unauthorized |

---

### GET /api/v1/books/series/{name}

Get books in a specific series

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `name` | path | Yes | Series name |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Books in series |
| 401 | Unauthorized |

---

### GET /api/v1/books/{id}/metadata

Get book metadata by media ID

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `id` | path | Yes | Media item ID |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Book metadata |
| 401 | Unauthorized |
| 404 | Not found |

---

### GET /api/v1/books/{id}/progress

Get reading progress for a book

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `id` | path | Yes | Media item ID |

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Reading progress |
| 401 | Unauthorized |
| 404 | Not found |

---

### PUT /api/v1/books/{id}/progress

Update reading progress for a book

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In | Required | Description |
|------|----|----------|-------------|
| `id` | path | Yes | Media item ID |

#### Request Body

`Content-Type: application/json`

See `docs/api/openapi.json` for the full schema.

#### Responses

| Status | Description |
|--------|-------------|
| 204 | Progress updated |
| 400 | Bad request |
| 401 | Unauthorized |

---