Comments

Get 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 for details on using cursor-based pagination.

get/api/v1/comments

Request

Base URL
https://api.todoist.com
URL
https://api.todoist.com/api/v1/comments
Auth
none declared

Query parameters

project_idstring nullable

String ID of the project

Example:6XGgm6PHrGgMpCFX

task_idstring nullable

String ID of the task

Example:6XGgmFVcrG5RRjVr

cursorstring nullable

An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request

Example:14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55

limitinteger

The number of objects to return in a page

Example:50

public_keystring nullable

Public project access key.

Example:550e8400-e29b-41d4-a716-446655440000

Response

Successful Response

next_cursorstring nullable required

Cursor for the next page of results, or null when there are no more results.

Example response

{
  "results": [
    {
      "id": "6XGgmFQrx44wfGHr",
      "posted_uid": "1234567",
      "content": "Looks good to me.",
      "uids_to_notify": [
        "1234567"
      ],
      "posted_at": "2025-01-15T10:30:00Z",
      "reactions": {
        "👍": [
          "1234567"
        ]
      }
    }
  ],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}

Changes

No recorded changes to this operation across all 34 revisions of this API.