[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Ftasks\u002Fchecklist\u002Flist":3,"docs-tabs-entities\u002Ftasks\u002Fchecklist\u002Flist":6},{"content":4,"lastmod":5},"## List checklist items\n\n`GET \u002Fv1\u002Ftasks\u002F:taskId\u002Fchecklist`\n\nReturns all items of a task's checklist, including nested (child) items.\n\n## Parameters\n\n| Parameter | Type | Required | Description |\n|----------|-----|:-----:|---------|\n| `taskId` (path) | integer | yes | Task ID. List: [`GET \u002Fv1\u002Ftasks`](\u002Fdocs\u002Fentities\u002Ftasks\u002Flist) |\n| `sort` (query) | string | no | Sorting in the `field:direction` format, for example `sortIndex:asc`. Fields: `id`, `parentId`, `createdBy`, `title`, `sortIndex`, `isComplete`, `isImportant`, `toggledBy`, `toggledDate`. Direction: `asc` or `desc` (default `asc`). Without the parameter, items are ordered by `sortIndex` ascending, as with `sortIndex:asc` |\n| `start` (query) | integer | no | Accepted but does not shift the result: any value returns every checklist item. Must be a non-negative integer, otherwise `400 INVALID_PARAMS` |\n\n**Pagination.** There is no paging: all checklist items come in one response, and `meta.total` equals the number of elements in `data`.\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Ftasks\u002F3943\u002Fchecklist?sort=sortIndex:asc\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth application\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Ftasks\u002F3943\u002Fchecklist?sort=sortIndex:asc\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch(\n  \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Ftasks\u002F3943\u002Fchecklist?sort=sortIndex:asc\",\n  { headers: { \"X-Api-Key\": \"YOUR_API_KEY\" } }\n);\nconst { data } = await res.json();\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch(\n  \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Ftasks\u002F3943\u002Fchecklist?sort=sortIndex:asc\",\n  {\n    headers: {\n      \"X-Api-Key\": \"YOUR_APP_KEY\",\n      \"Authorization\": \"Bearer USER_SESSION_TOKEN\",\n    },\n  }\n);\nconst { data } = await res.json();\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|---------|\n| `success` | boolean | Always `true` on success |\n| `data` | array | Array of checklist items |\n| `data[].id` | string | Item ID |\n| `data[].taskId` | string | Parent task ID |\n| `data[].parentId` | integer \u002F string | ID of the parent item from the same list. `0` — a top-level item (itself a checklist) |\n| `data[].title` | string | Item text |\n| `data[].sortIndex` | string | Sort index |\n| `data[].isComplete` | string | Completion status — `\"Y\"` \u002F `\"N\"` |\n| `data[].isImportant` | string | Importance flag — `\"Y\"` \u002F `\"N\"` |\n| `data[].createdBy` | string | ID of the item author. Employee list: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist) |\n| `data[].toggledBy` | string \\| null | ID of the employee who last changed the completion status. Employee list: [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist) |\n| `data[].toggledDate` | string | When the status was last changed. An empty string if never changed |\n| `data[].members` | array | Item members — objects `{ id, type, name, personalPhoto, personalGender, image, isCollaber }`. `id` — the employee ID from [`GET \u002Fv1\u002Fusers`](\u002Fdocs\u002Fentities\u002Fusers\u002Flist) |\n| `data[].attachments` | array \\| object | Item attachments. Without attachments — an empty array. With attachments — an object keyed by attachment ID, each value an object with the fields `attachmentId`, `name`, `size`, `fileId` (the Drive file ID), `downloadUrl`, `viewUrl` |\n| `meta.total` | number | Total number of items in the result set |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": \"211\",\n      \"taskId\": \"3943\",\n      \"parentId\": 0,\n      \"createdBy\": \"1317\",\n      \"title\": \"Documents\",\n      \"sortIndex\": \"1\",\n      \"isComplete\": \"N\",\n      \"isImportant\": \"N\",\n      \"toggledBy\": null,\n      \"toggledDate\": \"\",\n      \"members\": [],\n      \"attachments\": []\n    },\n    {\n      \"id\": \"213\",\n      \"taskId\": \"3943\",\n      \"parentId\": \"211\",\n      \"createdBy\": \"1317\",\n      \"title\": \"Collect and check documents\",\n      \"sortIndex\": \"100\",\n      \"isComplete\": \"N\",\n      \"isImportant\": \"Y\",\n      \"toggledBy\": null,\n      \"toggledDate\": \"\",\n      \"members\": [\n        {\n          \"id\": \"1317\",\n          \"type\": \"A\",\n          \"name\": \"Jane Doe\",\n          \"personalPhoto\": \"35959\",\n          \"personalGender\": \"\",\n          \"image\": \"https:\u002F\u002Fexample.bitrix24.com\u002F...\",\n          \"isCollaber\": false\n        }\n      ],\n      \"attachments\": []\n    }\n  ],\n  \"meta\": { \"total\": 2 }\n}\n```\n\n## Error response example\n\n`404` — Bitrix24 reported that the task does not exist or is not accessible:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"TASK_NOT_FOUND\",\n    \"message\": \"Task not found or not accessible.\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `taskId` is not a positive integer, the sort field is unknown, or `start` is not a non-negative integer |\n| 404 | `TASK_NOT_FOUND` | Bitrix24 reported `TASK_NOT_FOUND_OR_NOT_ACCESSIBLE`: the task is missing or not accessible to the key |\n| 422 | `BITRIX_ERROR` | Any other Bitrix24 error without a more specific error code |\n| 429 | `RATE_LIMITED` | Bitrix24 throttled the request. Respect the `Retry-After` header |\n| 403 | `SCOPE_DENIED` | The API key lacks the `task` scope |\n| 401 | `TOKEN_MISSING` | The API key has no configured tokens |\n| 400 | `UNSUPPORTED_FILTER` | A `filter` parameter was passed, and this endpoint has none. The error text names what to use instead |\n\nFull list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\n- **An existing task without items returns `200` with an empty array.**\n\n- **`parentId: 0` — a top-level item that is itself a checklist.** Child items reference its `id` via their own `parentId`.\n- **Numeric values and flags are strings.** `id`, `taskId`, `sortIndex` arrive as strings. `isComplete` \u002F `isImportant` are the strings `\"Y\"`\u002F`\"N\"`, not booleans.\n\n## See also\n\n- [Get an item](.\u002Fget.md)\n- [Add an item](.\u002Fcreate.md)\n- [Save a task checklist](\u002Fdocs\u002Fentities\u002Ftasks\u002Fchecklist-actions\u002Ftree)\n- [Tasks](\u002Fdocs\u002Fentities\u002Ftasks)\n","2026-10-21",{},1794739431948]