TOtodoist
Tasks

Get Tasks

Changed on

Get all active tasks for the user.

All provided parameters are used to narrow down the list of tasks.

This is a paginated endpoint. See the Pagination guide for details on using cursor-based pagination.

get/api/v1/tasks

Request

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

Query parameters

project_idstring nullable

String ID of the project to get tasks from

Example:6XGgm6PHrGgMpCFX
section_idstring nullable

String ID of the section to get tasks from

Example:6fFPHV272WWh3gpW
parent_idstring nullable

String ID of the parent task to get sub-tasks from

Example:6fFPHRxcmVqm4C84
labelstring nullable

Filter tasks by label name.

Example:next_action
idsstring nullable

A list of the task IDs to retrieve, this should be a comma separated list

Example:6XGgmFVcrG5RRjVr,6fFPHV272WWh3gpW
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

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": [
    {
      "user_id": "1234567",
      "id": "6XGgmFVcrG5RRjVr",
      "project_id": "6XGgm6PHrGgMpCFX",
      "section_id": "6fFPHV272WWh3gpW",
      "parent_id": "6XGgmFVcrG5RRjVr",
      "added_by_uid": "1234567",
      "assigned_by_uid": "1234567",
      "responsible_uid": "1234567",
      "labels": [
        "priority"
      ],
      "deadline": {
        "date": "2025-02-12",
        "lang": "en"
      },
      "duration": {
        "amount": 30,
        "unit": "minute"
      },
      "added_at": "2025-01-15T10:30:00Z",
      "completed_at": "2025-01-16T10:30:00Z",
      "completed_by_uid": "1234567",
      "updated_at": "2025-01-17T10:30:00Z",
      "due": {
        "date": "2025-02-12",
        "is_recurring": false,
        "lang": "en",
        "string": "tomorrow"
      },
      "priority": 1,
      "child_order": 1,
      "order_key": "a1V",
      "content": "Buy milk",
      "description": "Pick up organic milk",
      "day_order": 1,
      "completed_count": 3,
      "postponed_count": 1
    }
  ],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}

Changes