---
title: "List By Text"
method: GET
path: "/api/annotations"
tags: ["annotations"]
---

# List By Text

`GET /api/annotations`

## Request

- Base URL: `https://fojin.app` (the document declares no server; this is the origin it was published from)
- URL: `https://fojin.app/api/annotations`
- Auth: HTTP bearer

获取指定文本卷的标注列表（公开的 approved + 本人的全部状态）。

## Query parameters

- `text_id` integer, required
- `juan_num` integer

## Response `200`

Successful Response

- AnnotationResponse[]
  - `id` integer, required
  - `text_id` integer, required
  - `juan_num` integer, required
  - `start_pos` integer, required
  - `end_pos` integer, required
  - `annotation_type` string, required
  - `content` string, required
  - `user_id` integer, required
  - `status` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform.md) · [All operations](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/revisions/969714238c61?raw)