---
title: "List Annotations"
method: GET
path: "/apps/annotations"
tags: ["Annotations"]
---

# List Annotations

`GET /apps/annotations`

**Available for**: Chatflow, Chatbot, Agent apps.

Lists the app's annotations, optionally filtered by keyword.

## Query parameters

- `page` integer
- `limit` integer
- `keyword` string

## Response `200`

Successfully retrieved annotation list.

- AnnotationListResponse
  - `data` AnnotationItem[] — List of annotation items for the current page.
    - `id` string, uuid — Unique annotation identifier.
    - `question` string, nullable — Question text that triggers this annotation.
    - `answer` string, nullable — Predefined answer returned when the annotation is matched.
    - `hit_count` integer, nullable — Number of times this annotation has been matched and returned as a reply.
    - `created_at` integer, nullable — Creation timestamp (Unix epoch seconds).
  - `has_more` boolean — `true` if more pages are available beyond the current result set.
  - `limit` integer — Number of items per page.
  - `total` integer — Total number of annotations matching the query.
  - `page` integer — Current page number.

---

[API](https://skmtc.net/langgenius/apis/dify-service-api.md) · [All operations](https://skmtc.net/langgenius/apis/dify-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langgenius/dify-service-api/revisions/e49b3db72bad/schema)