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

# List Series

Returns a paginated list of series for the requesting user's visible libraries.

## Example response

```json example-response
{
  "series": [
    {
      "name": "The Witcher",
      "library_id": "550e8400-e29b-41d4-a716-446655440000",
      "book_count": 5,
      "total_in_series": 8,
      "cover_paths": [],
      "last_entry_at": "2026-10-24T13:57:01Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}
```

## Query parameters

| Param | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| library_id | uuid | No | Scope to one library (must be visible) |
| limit | int | No | 1-100 (default 20) |
| offset | int | No | Pagination offset |

## Errors

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