---
method: GET
path: /api/series/books
auth: jwt
area: series
---
<!-- source: internal/handlers/series.go:112 SeriesHandler.GetSeriesBooks -->

# Get Series Books

Returns the books belonging to a named series within a library.

## Example response

```json example-response
{
  "name": "The Witcher",
  "library_id": "550e8400-e29b-41d4-a716-446655440000",
  "books": [
    {
      "media_item_id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "The Last Wish",
      "author": "Andrzej Sapkowski",
      "cover_image_path": "",
      "has_conflict": false,
      "format_group": "ebook",
      "badge": ""
    }
  ],
  "total": 1
}
```

## Query parameters

| Param | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| name | string | Yes | Series name |
| library_id | uuid | Yes | Library containing the series (must be visible) |

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "name required"}` / `{"error": "library_id required"}` / `{"error": "invalid library_id"}` | missing or malformed params |
| 403 | `{"error": "library not accessible"}` | library not in visible set |
| 500 | `{"error": "Failed to load series books"}` | unexpected server error |