# Read the day plan

`GET /v1/tasks/day-plan`

Bitrix24 REST: `task.planner.getlist`. Scope: `task`.

Returns {taskIds:number[]}. With ?expand=tasks it also returns tasks in the task entity projection, read through tasks.task.list with permissions; inaccessible tasks may be absent while their ids remain. Only the key owner plan is available. READONLY keys are allowed.

**Bitrix24 truncates a plan longer than 30 tasks on every read and SAVES the truncation**, just as its widget does. Completed tasks remain until the next workday starts. There is no REST method to add/remove tasks from this plan: use the widget or the task timer. The day plan and My Plan kanban are separate features.

## Example

```bash
curl -X GET "https://vibecode.bitrix24.com/v1/tasks/day-plan" \
  -H "X-Api-Key: YOUR_API_KEY"
```

Writes require a READWRITE key. No automatic retry after timeout: reread the object before retrying. Bitrix24 permission refusals return 403; other business refusals return 422.

[Stage list](/docs/task-stages)
