---
title: "Get all simulations"
method: GET
path: "/simulations/batches"
tags: ["Simulations"]
---

# Get all simulations

`GET /simulations/batches`

Retrieve a paginated list of all simulations.

## Query parameters

- `projectId` string, required
- `filter` string
- `limit` integer
- `skip` integer
- `sort` string
- `next` string
- `previous` string
- `status` 'STOPPED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'
- `timespan` string
- `timezone` string
- `endPointType` string
- `scenariosIds` string[]

## Response `200`

List of simulations retrieved successfully

- object
  - `data` object[] — Array of simulation objects
    - `id` string, required — Unique identifier for the simulation
    - `referenceId` string, required — Reference ID for the simulation
    - `simulationReference` string, required — Reference ID of the simulated scenario
    - `status` 'pending' | 'running' | 'completed' | 'failed' | 'stopped', required — Current status of the simulation
    - `runs` integer, required — Number of runs in this simulation
    - `completedRuns` integer, required — Number of completed runs
    - `failedRuns` integer, required — Number of failed runs
    - `createdAt` integer, required — Creation timestamp
    - `startedAt` integer, nullable — Start timestamp
    - `completedAt` integer, nullable — Completion timestamp
  - `pagination` object
    - `limit` integer, required — Number of items per page
    - `skip` integer, required — Number of items skipped
    - `total` integer, required — Total number of items
    - `hasNext` boolean, required — Whether there are more items
    - `hasPrevious` boolean, required — Whether there are previous items
    - `next` string, nullable — Cursor for next page
    - `previous` string, nullable — Cursor for previous page

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing authentication
- `403` — Forbidden - Insufficient permissions
- `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)