meta {
  name: Get Universal Progress
  type: http
  seq: 1
}

get {
  url: {{base_url}}/api/progress/{{mediaItemId}}
  body: none
  auth: inherit
}

headers {
  Authorization: Bearer {{jwt}}
  Content-Type: application/json
}

settings {
  encodeUrl: true
  timeout: 0
}

docs {
  ## Get Universal Progress

  Retrieves universal reading progress for a specific media item across all devices.

  **Method:** GET

  **Endpoint:** /api/progress/{mediaItemId}

  **Authentication:** Bearer token

  **Path Parameters:**
  - `mediaItemId` (string): Media item UUID

  **Response:**
  - `media_item_id` (string): Media item UUID
  - `progress` (object): Universal progress data
    - `percentage` (number): Overall progress percentage
    - `epubcfi` (string): EPUB location
    - `page` (number): Current page
    - `chapter` (number): Current chapter
  - `devices` (array): Per-device progress data
    - `device_id` (string): Device UUID
    - `device_name` (string): Device name
    - `progress` (object): Device-specific progress
  - `last_updated` (string): Last update timestamp

  **Status Codes:**
  - 200: Success
  - 401: Unauthorized
  - 404: Media item not found
  - 500: Internal server error
}