TOtodoist
Sections

Get Sections

Changed on

Get all active sections for the user, optionally filtered by project or workspace.

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

get/api/v1/sections

Request

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

Query parameters

project_idstring nullable

String ID of the project to get sections from. If omitted or null, get sections from all projects. If provided, workspace_id is ignored.

Example:6XGgm6PHrGgMpCFX
workspace_idinteger nullable

Numeric ID of the workspace.

Example:123456
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": "6fFPHV272WWh3gpW",
      "user_id": "1234567",
      "project_id": "6XGgm6PHrGgMpCFX",
      "added_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-16T10:30:00Z",
      "archived_at": "2025-01-17T10:30:00Z",
      "name": "Groceries",
      "description": "Tasks for the launch plan",
      "section_order": 1,
      "order_key": "a1V"
    }
  ],
  "next_cursor": "14540000435w8hj8pXXwPQJJch.X9DBH8ya2Xenok55"
}

Changes