---
title: "List Schedules of given category"
method: POST
path: "/v1/schedules/list"
tags: ["Schedules"]
---

# List Schedules of given category

`POST /v1/schedules/list`

List schedules of given Category

## Request body

- ScheduleListRequest
  - `list_context` ListContext
    - `batch_size` integer — Max number of ids in the response
    - `batch_offset` integer — Offset of batches into the results. First batch is 0
    - `total` integer — Total number of results
  - `sort` ScheduleListSortCriteria[] — Sort criteria
    - `column` 'Name' | 'CreatedAt' | 'UpdatedAt' | 'NextRun', required
    - `ascending` boolean
  - `filters` ScheduleFilter
    - `tenant_id` string, required — Tenant ID
    - `category` 'ComplianceStandard' | 'Policy' | 'PolicyRemediation' | 'Reports' | 'Script' | 'Template' — Category of the schedule
    - `is_active` boolean — Flag to represent whether the schedule is active or not.
    - `query` QueryOperator
      - `__type` string, required — Concrete type used for polymorphic deserialization (discriminator)

## Response `200`

Success

- ScheduleListResponse
  - `results` string[] — List of result identifiers
  - `next_list_context` ListContext
    - `batch_size` integer — Max number of ids in the response
    - `batch_offset` integer — Offset of batches into the results. First batch is 0
    - `total` integer — Total number of results

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)