---
method: GET
path: /api/media-items/:id
auth: jwt
area: media-items
---
<!-- source: internal/handlers/media.go:896 MediaHandler.GetMediaItem -->

# Get Media Item

Retrieve details of a specific media item.

**Endpoint**: `GET /api/media-items/{media_id}`
**Auth**: Required

## Path Parameters

| Parameter | Type   | Required | Description     |
| --------- | ------ | -------- | --------------- |
| media_id  | string | Yes      | Media item UUID |

## Request Headers

| Header        | Type   | Required | Description  |
| ------------- | ------ | -------- | ------------ |
| Authorization | string | Yes      | Bearer token |

### Example Request

```http
GET /api/media-items/uuid-here
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```

## Response (200 OK)

```json example-response
{
  "id": "uuid",
  "library_id": "uuid",
  "title": "Book Title",
  "author": "Author Name",
  "description": "Book description",
  "file_path": "/path/to/book.epub",
  "file_size": 1024000,
  "mime_type": "application/epub+zip",
  "cover_image_path": "/path/to/cover.jpg",
  "series": "Series Name",
  "series_number": 1,
  "tags": [
    "sci-fi",
    "space opera"
  ],
  "contributors": [
    "Author Name",
    "ACME CORP."
  ],
  "language": "en",
  "page_count": 350,
  "genre": "Science Fiction",
  "created_at": "2026-01-31T10:00:00Z",
  "abridged": null,
  "age_rating": null,
  "alternate_info": null,
  "asin": null,
  "authors": null,
  "community_rating": null,
  "date_published": null,
  "edition": null,
  "explicit": null,
  "format_group": null,
  "format_mimetype": null,
  "imprint": null,
  "is_black_and_white": null,
  "isbn": null,
  "library_type_name": null,
  "manga_type": null,
  "metadata_notes": null,
  "narrators": null,
  "publisher": null,
  "publishers": null,
  "reading_direction": null,
  "scan_information": null,
  "series_count": null,
  "story_arc": null,
  "subtitle": null,
  "summary": null,
  "updated_at": null,
  "volume": null,
  "web_url": null
}
```

## Error Responses

| Code | Description                                  |
| ---- | -------------------------------------------- |
| 401  | Invalid or expired token                     |
| 403  | User does not have access to this media item |
| 404  | Media item not found                         |