---
title: "Read a simulation"
method: GET
path: "/strategies/{strategy_uuid}/simulations/{id}"
tags: ["Simulations"]
---

# Read a simulation

`GET /strategies/{strategy_uuid}/simulations/{id}`

## Request

- Base URL: `https://kovatools.com/api/v1`
- URL: `https://kovatools.com/api/v1/strategies/{strategy_uuid}/simulations/{id}`
- Auth: HTTP bearer

Poll until status is completed or failed. Failed simulations return HTTP 200 with status failed. Missing, expired, or other-strategy results return 404.

## Path parameters

- `strategy_uuid` string, uuid, required
- `id` string, uuid, required

## Response `200`

Current processing, completed, or failed state

- object
  - `simulation` union, required
    - SimulationProcessing
      - `id` string, uuid, required
      - `status` 'processing', required
      - `poll_url` string, uri: Polling URL, present only in the create response.
      - `started_at` string, date-time, required
      - `elapsed_seconds` integer, required
      - `expected_duration_seconds` 120, required
      - `retry_after_seconds` integer, required
      - `message` string, required
    - SimulationCompleted
      - `id` string, uuid, required
      - `status` 'completed', required
      - `alignment` Alignment, required
        - `score` number, float: Alignment score between 0 and 1
        - `label` 'Strongly Aligned' | 'Aligned' | 'Partially Aligned' | 'Drifting' | 'Off-Track'
      - `content` string, required
      - `summary` string, nullable, required
      - `target_allocations` object[], nullable, required
      - `compliance_checks` object[], nullable, required
      - `generated_at` string, date-time, required
    - SimulationFailed
      - `id` string, uuid, required
      - `status` 'failed', required
      - `error` object, required
        - `code` string, required
        - `message` string, required
  - `meta` Meta, required
    - `request_id` string: Unique request identifier for debugging
    - `timestamp` string, date-time

## Other responses

- `401`: Missing or invalid Bearer token
- `403`: Active subscription required
- `404`: Resource not found or not owned by the authenticated user

---

[API](https://skmtc.dev/kovatools/apis/kova-api.md) · [All operations](https://skmtc.dev/kovatools/apis/kova-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kovatools/apis/kova-api/revisions/915eb7ffe3b6?raw)