---
title: "Get run by ID"
method: GET
path: "/api/v1/runs/{id}"
---

# Get run by ID

`GET /api/v1/runs/{id}`

Retrieve the run details by its ID

## Path parameters

- `id` string, required — The ID of the run to retrieve

## Response `200`

Successfully retrieved run details

- GetRunByIdResponse
  - `origin` string, required — The origin of the run
  - `status` string, required — The status of the run
  - `input` string, required — The input of the run
  - `output` string, required — The output of the run
  - `prompt` string, required — The prompt of the run
  - `inputTokens` number, required — The number of input tokens of the run
  - `outputTokens` number, required — The number of output tokens of the run
  - `cost` string, required — The cost of the run
  - `durationInMs` number, required — The duration of the run in milliseconds
  - `groupId` string, required — The group ID of the run
  - `model` object, required
    - `name` string, required — The name of the model
    - `tag` string, required — The tag of the model
  - `schema` string, nullable, required — The schema used to generate the object
  - `workflowId` string, required — The ID of the workflow
  - `createdAt` string, required — The creation date of the run

## Other responses

- `400` — Bad request - invalid input
- `401` — Unauthorized - invalid API key
- `403` — Forbidden - organization does not have an active subscription
- `404` — Not found - run not found
- `500` — Server error during retrieval

---

[API](https://skmtc.dev/itzam-ai/apis/itzam-api.md) · [All operations](https://skmtc.dev/itzam-ai/apis/itzam-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/itzam-ai/itzam-api/revisions/cc21b9e9916a/schema)