---
title: "Get scheduler configuration for a simulation"
method: GET
path: "/simulations/{simulationReference}/schedules"
tags: ["Simulations"]
---

# Get scheduler configuration for a simulation

`GET /simulations/{simulationReference}/schedules`

Retrieve the scheduler configuration associated with a specific simulation.

## Path parameters

- `simulationReference` string, required

## Query parameters

- `projectId` string, required

## Response `200`

Scheduler retrieved successfully

- object
  - `scheduler` object
    - `id` string
    - `simulationReference` string
    - `projectReference` string
    - `organisationReference` string
    - `runConfig` object
      - `flowReferenceId` string
      - `localeReferenceId` string
      - `entrypoint` string
      - `largeLanguageModelReferenceId` string
      - `userId` string
      - `finalPing` number
      - `data` object
      - `enableMocking` boolean
    - `enableSchedule` boolean
    - `frequency` 'daily' | 'every three days' | 'weekly' | 'biweekly' | 'monthly'
    - `time` string, date-time
    - `numberOfRuns` integer
    - `nextScheduledRun` string, date-time
    - `emailNotifications` string[]
    - `scenarioName` string
    - `runName` string
    - `endDate` string, date-time
    - `createdAt` integer
    - `lastChanged` integer
    - `createdBy` string
    - `lastChangedBy` string
    - `cronScheduler` string
    - `timezone` string — IANA timezone used for scheduler recurrence calculations. Derived by the server from the project timezone settings and persisted on the scheduler. Not set directly in scheduler create/update requests.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - Resource not found
- `500` — Internal Server Error - Server error

---

[API](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference.md) · [All operations](https://skmtc.net/cognigy/apis/simulator-openapi-rest-ful-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cognigy/simulator-openapi-rest-ful-api-reference/versions/85b2872bdfb7/schema)