---
title: "Get Comments"
method: GET
path: "/api/v1/comments"
tags: ["Comments"]
---

# Get Comments

`GET /api/v1/comments`

Get all comments for a given task or project.

Exactly one of `task_id` or `project_id` arguments is required. Providing
neither or both will return an error.

This is a paginated endpoint. See the [Pagination guide](#tag/Pagination) for details on using cursor-based pagination.

## Query parameters

- `project_id` string, nullable — String ID of the project
- `task_id` string, nullable — String ID of the task
- `cursor` string, nullable — An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
- `limit` integer — The number of objects to return in a page
- `public_key` string, nullable — Public project access key.

## Response `200`

Successful Response

- PaginatedListNoteSyncView
  - `results` NoteSyncView[], required — Objects in the current page of results.
    - `id` string, required — String ID of the comment.
    - `posted_uid` string, nullable, required — String ID of the user who posted the comment.
    - `content` string — Comment content.
    - `file_attachment` object, nullable, required — File attachment metadata, or `null` when the comment has no attachment.
    - `uids_to_notify` string[], nullable, required — String IDs of users notified by the comment.
    - `is_deleted` boolean, required — Whether the comment is deleted.
    - `posted_at` string, date-time, nullable, required — Date and time when the comment was posted, or `null` if unknown.
    - `reactions` object, nullable, required — Reaction emoji mapped to user IDs that reacted.
  - `next_cursor` string, nullable, required — Cursor for the next page of results, or `null` when there are no more results.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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