---
title: "List simulation runs for a simulation"
method: GET
path: "/projects/{projectId}/simulations/{simulationId}/runs"
tags: ["Simulation Runs"]
---

# List simulation runs for a simulation

`GET /projects/{projectId}/simulations/{simulationId}/runs`

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

Successful operation

- object
  - `_links` CollectionLinks
    - `first` object
      - `href` string — First page of the collection.
    - `prev` object
      - `href` string — Previous page in the collection.
    - `self` object
      - `href` string — Current page of the collection.
    - `next` object
      - `href` string — Next page in the collection.
    - `last` object
      - `href` string — Last page of the collection.
  - `_meta` CollectionMeta
    - `total` integer — Total number of resources in the collection.
  - `_embedded` SimulationRun[]
    - `runId` string, uuid
    - `name` string, required — The name of the simulation run.
    - `createdAt` string, date-time — The time when the simulation run was created.
    - `startedAt` string, date-time — The time when the simulation run was started.
    - `finishedAt` string, date-time — The time when the simulation run was finished.
    - `duration` string, duration — The actual duration of the simulation run.
    - `computeResource` SimulationRunComputeResource — The actual compute resources (CPUh or GPUh) consumed by the simulation run.
      - `type` 'CPU_HOURS' | 'GPU_HOURS'
      - `value` number, double
    - `status` 'READY' | 'QUEUED' | 'RUNNING' | 'FINISHED' | 'CANCELED' | 'FAILED' — Status of the operation.
    - `progress` number — The current progress while the simulation run is in progress.

## Other responses

- `404` — Not found.

---

[API](https://skmtc.net/simscale/apis/simscale-api.md) · [All operations](https://skmtc.net/simscale/apis/simscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/simscale/simscale-api/revisions/53223abaceb7/schema)