# Cognite Simulation Runs API

**Canonical:** https://apis.io/apis/cognite/cognite-simulation-runs-api/  
**Provider:** Cognite — https://apis.io/providers/cognite/  
**Base URL:** https://api.cognitedata.com  
**Documentation:** https://api-docs.cognite.com/

Cognite Simulation Runs API is one of 90 APIs that [Cognite](https://apis.io/providers/cognite/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Simulation Runs. The published artifact set on APIs.io includes an OpenAPI specification.

Every time a simulation routine executes, a simulation run object is created. This object ensures that each execution of a routine is documented and traceable. Each run has an associated simulation data resource, which stores the inputs and outputs of a simulation run, capturing the values set into and read from the simulator model to ensure the traceability and integrity of the simulation data. Simulation runs provide a historical record of the simulations performed, allowing users to analyze and compare different runs, track changes over time, and make informed decisions based on the simulation results. When simulation run load balancing is enabled and the routine is not assigned to any particular simulator integration, the run initiates with status `queued` and any active simulator integration can claim it automatically. Without load balancing, the run initiates with status `ready` and is tied to the simulator integration specified on the routine. #### Limitations: - A retention policy is in place for simulation runs, allowing up to 100000 entries. When this limit is reached, the oldest runs are deleted to make room for new ones. - The total size of all inputs for a simulation run can be a maximum of 50.00 KB. - The total size of simulation run data sent by the connector can be a maximum of 100.00 KB.

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cognite/refs/heads/main/openapi/cognite-simulation-runs-api-openapi.yml

## Other Cognite APIs (12)

- [Cognite Data Fusion API](https://apis.io/apis/cognite/cognite-data-fusion-api/)
- [Cognite 3D Asset Mapping API](https://apis.io/apis/cognite/cognite-3d-asset-mapping-api/)
- [Cognite 3D Files API](https://apis.io/apis/cognite/cognite-3d-files-api/)
- [Cognite 3D Jobs API](https://apis.io/apis/cognite/cognite-3d-jobs-api/)
- [Cognite 3D Model Revisions API](https://apis.io/apis/cognite/cognite-3d-model-revisions-api/)
- [Cognite 3D Models API](https://apis.io/apis/cognite/cognite-3d-models-api/)
- [Cognite Annotations API](https://apis.io/apis/cognite/cognite-annotations-api/)
- [Cognite Assets API](https://apis.io/apis/cognite/cognite-assets-api/)
- [Cognite Connections API](https://apis.io/apis/cognite/cognite-connections-api/)
- [Cognite Containers API](https://apis.io/apis/cognite/cognite-containers-api/)
- [Cognite Data models API](https://apis.io/apis/cognite/cognite-data-models-api/)
- [Cognite Data point subscriptions API](https://apis.io/apis/cognite/cognite-data-point-subscriptions-api/)

## Tags

Simulation Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cognite/cognite-simulation-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cognite/.