---
title: "Get shelf details"
method: GET
path: "/reader/shelves/{shelf_id}"
tags: ["Reader"]
---

# Get shelf details

`GET /reader/shelves/{shelf_id}`

Get shelf details with its books

## Path parameters

- `shelf_id` integer, required

## Response `200`

OK

- object
  - `data` object
    - `books` SchemaBook[]
      - `asin` string
      - `author` string
      - `author_sort` string
      - `author_url` string
      - `category` string
      - `count_download` integer
      - `count_visit` integer
      - `cover_url` string
      - `ctime` integer
      - `description` string
      - `file_type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7
      - `id` string
      - `identifier` string
      - `isbn` string
      - `language` string
      - `pubdate` string
      - `publisher` string — Publisher identifies the publication's publisher.
      - `publisher_url` string
      - `rating` number
      - `series` string — Series is the series to which this book belongs to.
      - `seriesIndex` string — SeriesIndex is the position in the series to which the book belongs to.
      - `size` integer
      - `sub_title` string
      - `tags` string[]
      - `title` string
      - `utime` integer
      - `uuid` string
    - `shelf` SchemaShelf
      - `book_count` integer
      - `cover_url` string
      - `ctime` integer
      - `description` string
      - `id` integer
      - `name` string
      - `sort_order` integer
      - `user_id` integer
      - `utime` integer

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/lxpio/apis/omnigram-api.md) · [All operations](https://skmtc.net/lxpio/apis/omnigram-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lxpio/omnigram-api/versions/58911ffb3093/schema)