---
title: "List Annotations"
method: GET
path: "/api/v1/projects/{project_id}/annotations"
tags: ["annotations"]
---

# List Annotations

`GET /api/v1/projects/{project_id}/annotations`

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `page_id` string, uuid, nullable
- `kind` string[], nullable
- `display_kind` string[], nullable
- `status` string[], nullable
- `author_id` string, uuid, nullable
- `author_kind` 'user' | 'agent' | 'imported', nullable
- `visibility` 'private' | 'project', nullable
- `q` string, nullable
- `linked_condition_id` string, uuid, nullable
- `include_deleted` boolean
- `sort` 'created_at' | 'updated_at' | 'page' | 'status' | 'subject' | 'author' | 'display_kind' | 'comments' | 'color'
- `direction` 'asc' | 'desc'
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- AnnotationListResponse
  - `items` AnnotationListRow[]
    - `annotation` Annotation, required — unresolved $ref
    - `drawing_id` string, uuid, required
    - `drawing_name` string, required
    - `page_number` integer, required
    - `sheet_number` string, nullable, required
    - `comment_count` integer
  - `next_cursor` string, nullable

## Other responses

- `4XX` — Client Error
- `5XX` — Server Error

---

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