---
title: "Get a run"
method: GET
path: "/runs/{run_id}"
tags: ["runs"]
---

# Get a run

`GET /runs/{run_id}`

Returns one run by ID, scoped to the caller's organization.

## Path parameters

- `run_id` string, uuid, required — run identifier

## Response `200`

OK

- RunResponse — Full run record returned by run endpoints.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `canceled_at` string, date-time — Timestamp when the run was cancelled.
  - `completed_at` string, date-time — Timestamp when the run finished.
  - `created_at` string, date-time, required — Timestamp when the run record was created.
  - `error_message` string — Error details if the run failed.
  - `id` string, uuid, required — Run identifier.
  - `phone_id` string — Device executing the run.
  - `run_metadata` object — Arbitrary metadata attached to the run.
  - `session_id` string, uuid — Session associated with this run.
  - `start_timeout_seconds` integer — How long the queued run may wait for a phone before auto-cancel.
  - `started_at` string, date-time — Timestamp when the run began executing.
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'cancelled', required — Current lifecycle state of the run.
  - `success` boolean — Whether the run completed without error.
  - `trace_expired_at` string, date-time — When the trace recording was deleted.
  - `trigger` 'manual' | 'scheduled' | 'api', required — Trigger identifies how the run was initiated.
  - `updated_at` string, date-time, required — Timestamp of the last update to the run record.
  - `user_id` string, uuid, required — User who initiated the run.
  - `variables` object — Variable configuration used for the run.
  - `video_url` string — URL for the run recording video.
  - `workflow_id` string, uuid, required — Workflow this run belongs to.
  - `workflow_name` string — Display name of the workflow this run belongs to.

## Other responses

- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

## Changes

- **2026-08-20** `4a74befa0bde` — 1 warning
  - removed the optional property `logs` from the response with the `200` status
- **2026-08-17** `e2261ff54e62` — 4 info
  - the endpoint scheme security `bearerAuth` was removed from the API
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - added the non-success response with the status `500`
- **2026-08-05** `108ab4b41051` — 1 info
  - added the optional property `workflow_name` to the response with the `200` status
- **2026-07-23** `5a989777701c` — 1 breaking
  - for the `path` request parameter `run_id`, the type/format was changed from `string`/`` to `string`/`uuid`

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/runs/:run_id/get.md)

---

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