# List Schedules

List RPA schedules for the team, page by page.
- **Effect**: none. Read-only. Safe to retry with bounded backoff.
- **Use**: `taskState` on each schedule is the completion signal for `/cloudphone/rpa/task/cancel`.

Endpoint: POST /api/cloudphone/rpa/task/page
Version: 2026-09-05

## Request fields (application/json):

  - `enabled` (boolean | null)
    Is the plan enabled

  - `searchKey` (string | null)
    Fuzzy search across schedule name, description, and template title

  - `taskState` (integer | null)
    Schedule status; 0:awaiting execution; 1:Executing; 2:Execution completed 3:Cancel

  - `pageNo` (integer | null)
    default:1

  - `pageSize` (integer | null)
    default:10

## Response 200:

  - `200` (unknown)
    Success. `data.dataList` holds the records for the requested page and is an empty array when there are no matches; `data.total`, `data.current` and `data.pages` describe the paging.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Response code, 0 indicates success,>0 indicates failure

  - `msg` (string | null, required)
    Error msg

  - `requestId` (string, required)
    Request trace id

  - `data` (object, required)

  - `data.dataList` (array, required)
    Plan list

  - `data.dataList.id` (string)
    Schedule id

  - `data.dataList.taskName` (string)
    Schedule Task name

  - `data.dataList.createMember` (string, required)
    Member name

  - `data.dataList.enabled` (boolean)
    Whether enabled

  - `data.dataList.endTime` (string)
    Task end time

  - `data.dataList.failCount` (integer)
    Number of failed executions

  - `data.dataList.handleTime` (string)
    Execution start time

  - `data.dataList.notes` (string)
    schedule notes

  - `data.dataList.scheduleConfig` (string)
    Task schedule configuration

  - `data.dataList.successCount` (integer)
    Number of successful executions

  - `data.dataList.taskPreviewTimeTable` (array)

  - `data.dataList.taskPreviewTimeTable.cloudPhoneId` (string)
    Cloud phone ID

  - `data.dataList.taskPreviewTimeTable.cloudPhoneName` (string)
    Cloud phone name

  - `data.dataList.taskPreviewTimeTable.times` (array)
    List of execution times

  - `data.dataList.taskState` (integer)
    Schedule Task state. 0:waiting; 1:running; 2:completed 3:Cancel

  - `data.dataList.templateId` (string)
    Template id

  - `data.dataList.templateTitle` (string)
    Template title

  - `data.current` (string, required)
    Current page number

  - `data.pages` (string, required)
    Total pages

  - `data.total` (string, required)
    Total count

