---
title: "Get an agent run"
method: GET
path: "/v1/agents/{agent_id}/runs/{run_id}"
tags: ["Agents"]
---

# Get an agent run

`GET /v1/agents/{agent_id}/runs/{run_id}`

Retrieve the current status and result details for an agent run.

## Path parameters

- `agent_id` string, uuid, required — The ID of the agent that owns the run.
- `run_id` string, uuid, required — The ID of the run to retrieve.

## Response `200`

Successful Response

- AgentRun — Status and result details for an agent run.
  - `id` string, uuid, required — Unique ID for the run.
  - `agent_id` string, uuid, required — Unique ID of the agent for this run.
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'skipped' | 'unknown', required — Current execution status for an agent run.
  - `started_at` string, date-time, nullable — When the run started, if it has started.
  - `finished_at` string, date-time, nullable — When the run finished, if it has completed.
  - `error` object, nullable — Error details, when the run fails and error information is available.
  - `outputs` object — Output values returned by the run, keyed by variable ID. This object conforms to `schema.output` from the agent detail response and is empty when no outputs are available.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.net/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/revisions/ab03b3c80494/schema)