---
title: "List annotations"
method: GET
path: "/reader/books/{book_id}/annotations"
tags: ["Reader"]
---

# List annotations

`GET /reader/books/{book_id}/annotations`

Get all annotations for a book, with optional pagination

## Path parameters

- `book_id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `data` SchemaAnnotation[]
    - `book_id` string
    - `cfi` string
    - `chapter` string
    - `color` string
    - `content` string
    - `ctime` integer
    - `device_id` string
    - `id` integer
    - `page_number` integer
    - `position` string
    - `selected_text` string
    - `type` 'note' | 'highlight' | 'bookmark'
    - `user_id` integer
    - `utime` integer

## Changes

- **2026-04-23** `20e19d9cbb5a` — 2 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
- **2026-03-21** `ffed97aaec4f` — 2 warning
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`

[Change history](https://skmtc.dev/lxpio/apis/omnigram-api/changes/reader/books/:book_id/annotations/get.md)

---

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