---
title: "POST /tasks.task.list"
method: POST
path: "/tasks.task.list"
tags: ["tasks"]
---

# POST /tasks.task.list

`POST /tasks.task.list`

## Request body

- object
  - `select` string[]
  - `filter` unknown[]
    - unknown
  - `order` object
    - `id` string
    - `title` string
    - `creatorId` string
    - `created` string
    - `responsibleId` string
    - `deadline` string
    - `startPlan` string
    - `endPlan` string
    - `groupId` string
    - `priority` string
    - `status` string
    - `started` string
    - `estimatedTime` string
    - `changed` string
    - `closed` string
    - `activity` string
    - `mark` string
    - `allowsChangeDeadline` string
    - `allowsTimeTracking` string
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `offset` integer

## Response `200`

Success response

- object
  - `result` BitrixTasksTaskdto[]
    - `id` integer
    - `title` string
    - `description` string
    - `creatorId` integer
    - `creator` BitrixTasksUserdto
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `created` string, date-time
    - `responsibleId` integer
    - `responsible` BitrixTasksUserdto
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `deadline` string, date-time
    - `needsControl` boolean
    - `startPlan` string, date-time
    - `endPlan` string, date-time
    - `fileIds` unknown[]
      - unknown
    - `checklist` unknown[]
      - unknown
    - `groupId` integer
    - `group` BitrixTasksGroupdto
      - `id` integer
      - `name` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `type` string
      - `isVisible` boolean
    - `stageId` integer
    - `stage` BitrixTasksStagedto
      - `id` integer
      - `title` string
      - `color` string
    - `epicId` integer
    - `storyPoints` integer
    - `flowId` integer
    - `flow` BitrixTasksFlowdto
      - `id` integer
      - `name` string
    - `priority` string
    - `status` string
    - `statusChanged` string, date-time
    - `accomplices` BitrixTasksUserdto[]
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `auditors` BitrixTasksUserdto[]
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `parentId` integer
    - `parent` BitrixTasksTaskdto — recursive
    - `containsChecklist` boolean
    - `containsSubTasks` boolean
    - `containsRelatedTasks` boolean
    - `containsGanttLinks` boolean
    - `containsPlacements` boolean
    - `containsResults` boolean
    - `numberOfReminders` integer
    - `chatId` integer
    - `chat` BitrixTasksChatdto
      - `id` integer
      - `entityId` integer
      - `entityType` string
    - `plannedDuration` integer
    - `actualDuration` integer
    - `durationType` string
    - `started` string, date-time
    - `estimatedTime` integer
    - `replicate` boolean
    - `changed` string, date-time
    - `changedById` integer
    - `changedBy` BitrixTasksUserdto
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `statusChangedById` integer
    - `statusChangedBy` BitrixTasksUserdto
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `closedById` integer
    - `closedBy` BitrixTasksUserdto
      - `id` integer
      - `name` string
      - `role` string
      - `image` BitrixTasksFiledto
        - `id` integer
        - `src` string
        - `name` string
        - `width` integer
        - `height` integer
        - `size` integer
        - `subDir` string
        - `contentType` string
        - `file` unknown[]
          - unknown
      - `gender` string
      - `email` string
      - `externalAuthId` string
      - `rights` unknown[]
        - unknown
    - `closed` string, date-time
    - `activity` string, date-time
    - `guid` string
    - `xmlId` string
    - `exchangeId` string
    - `exchangeModified` string
    - `outlookVersion` integer
    - `mark` string
    - `allowsChangeDeadline` boolean
    - `allowsTimeTracking` boolean
    - `matchesWorkTime` boolean
    - `addInReport` boolean
    - `isMultitask` boolean
    - `siteId` string
    - `forkedByTemplateId` integer
    - `forkedByTemplate` BitrixTasksTemplatedto
      - `id` integer
      - `task` BitrixTasksTaskdto — recursive
      - `title` string
      - `description` string
      - `creator` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `responsibleCollection` unknown[]
        - unknown
      - `deadlineAfterTs` integer
      - `startDatePlanTs` integer
      - `endDatePlanTs` integer
      - `replicate` boolean
      - `fileIds` unknown[]
        - unknown
      - `checklist` unknown[]
        - unknown
      - `group` BitrixTasksGroupdto
        - `id` integer
        - `name` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `type` string
        - `isVisible` boolean
      - `priority` string
      - `accomplices` unknown[]
        - unknown
      - `auditors` unknown[]
        - unknown
      - `parent` BitrixTasksTemplatedto — recursive
      - `replicateParams` BitrixTasksReplicateparamsdto
        - `period` string
        - `everyDay` string
        - `workdayOnly` string
        - `dailyMonthInterval` string
        - `everyWeek` string
        - `monthlyType` string
        - `monthlyDayNum` string
        - `monthlyMonthNum1` string
        - `monthlyWeekDayNum` string
        - `monthlyWeekDay` string
        - `monthlyMonthNum2` string
        - `yearlyType` string
        - `yearlyDayNum` string
        - `yearlyMonth1` string
        - `yearlyWeekDayNum` string
        - `yearlyWeekDay` string
        - `yearlyMonth2` string
        - `time` string
        - `timezoneOffset` string
        - `startDate` string
        - `repeatTill` string
        - `endDate` string
        - `times` string
    - `deadlineCount` integer
    - `declineReason` string
    - `forumTopicId` integer
    - `tags` BitrixTasksTagdto[]
      - `id` integer
      - `name` string
      - `ownerId` integer
      - `owner` BitrixTasksUserdto
        - `id` integer
        - `name` string
        - `role` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `gender` string
        - `email` string
        - `externalAuthId` string
        - `rights` unknown[]
          - unknown
      - `groupId` integer
      - `group` BitrixTasksGroupdto
        - `id` integer
        - `name` string
        - `image` BitrixTasksFiledto
          - `id` integer
          - `src` string
          - `name` string
          - `width` integer
          - `height` integer
          - `size` integer
          - `subDir` string
          - `contentType` string
          - `file` unknown[]
            - unknown
        - `type` string
        - `isVisible` boolean
      - `taskId` integer
      - `task` BitrixTasksTaskdto — recursive
    - `link` string
    - `userFields` BitrixTasksUserfielddto[]
      - `id` integer
      - `key` string
      - `value` unknown
    - `rights` unknown[]
      - unknown
    - `archiveLink` string
    - `crmItemIds` unknown[]
      - unknown
    - `crmItems` BitrixTasksCrmitemdto
      - `id` integer
      - `type` string
      - `title` string
    - `reminders` unknown[]
      - unknown
    - `elapsedTime` BitrixTasksElapsedtimedto
      - `id` integer
      - `userId` integer
      - `taskId` integer
      - `minutes` integer
      - `seconds` integer
      - `source` string
      - `text` string
      - `createdAtTs` integer
      - `startTs` integer
      - `stopTs` integer
    - `requireResult` boolean
    - `matchesSubTasksTime` boolean
    - `autocompleteSubTasks` boolean
    - `allowsChangeDatePlan` boolean
    - `emailId` integer
    - `email` BitrixTasksEmaildto
      - `id` integer
      - `taskId` integer
      - `mailboxId` integer
      - `title` string
      - `body` string
      - `from` string
      - `dateTs` integer
      - `link` string
    - `maxDeadlineChangeDate` string, date-time
    - `maxDeadlineChanges` integer
    - `requireDeadlineChangeReason` boolean
    - `inFavorite` unknown[]
      - unknown
    - `inPin` unknown[]
      - unknown
    - `inGroupPin` unknown[]
      - unknown
    - `inMute` unknown[]
      - unknown
    - `source` BitrixTasksSourcedto
      - `type` string
      - `data` unknown[]
        - unknown
    - `dependsOn` unknown[]
      - unknown
    - `scenarios` unknown[]
      - unknown

---

[API](https://skmtc.net/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.net/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrix24/bitrix24-rest-v3-api/versions/3660cc6bfaf5/schema)
