latestOpenAPI 3.1.02026-08-211061591.1 MB

69a962f1578f

Tasks

Tasks Completed By Completion Date

Retrieves a list of completed tasks strictly limited by the specified completion date range (up to 3 months).

It can retrieve completed items:

From all the projects the user has joined in a workspace
From all the projects of the user
That match many supported filters

By default, the response is limited to a page containing a maximum of 50 items (configurable using limit).

Subsequent pages of results can be fetched by using the next_cursor value from the response as the cursor value for the next request.

get/api/v1/tasks/completed/by_completion_date

Query parameters

sincestring date-time required

Start of the completion date range, inclusive.

Example:2025-02-01T00:00:00Z

untilstring date-time required

End of the completion date range, exclusive.

Example:2025-02-28T23:59:59Z

workspace_idinteger nullable

Workspace ID to limit completed tasks to.

Example:123456

project_idstring nullable

Project ID to limit completed tasks to.

Example:6XGgm6PHrGgMpCFX

section_idstring nullable

Section ID to limit completed tasks to.

Example:6fFPHV272WWh3gpW

parent_idstring nullable

Parent task ID to limit completed subtasks to.

Example:6XGgmFVcrG5RRjVr

filter_querystring nullable

Todoist filter query to limit completed tasks.

Example:#Work & overdue

filter_langstring nullable

Language code used to parse filter_query.

Example:en

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

Maximum number of completed tasks to return.

Example:50

public_keystring nullable

Public project access key.

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

Response

Successful Response

next_cursorstring

Cursor for the next page of completed tasks, when more results are available. Omitted when there is no next page.

Example response

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