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

# Get a run

`GET /tools/runs/{run_id}`

## Request

- Base URL: `https://api.orcarouter.ai/v1`
- URL: `https://api.orcarouter.ai/v1/tools/runs/{run_id}`
- Auth: HTTP bearer

One of your runs with its input and output. `payload_state` says
whether the bodies are present.

## Path parameters

- `run_id` string, required

## Response `200`

OK

- object
  - `success` boolean
  - `data` object
    - `run_id` string
    - `connector_id` string: The tool id.
    - `agent_id` integer
    - `token_id` integer
    - `workspace_id` integer
    - `run_ref` string
    - `status` 'running' | 'completed' | 'failed' | 'blocked' | 'voided'
    - `quoted_usd` number
    - `billed_usd` number, nullable
    - `billing` 'unrecorded'
    - `sell_unit_usd` number
    - `units` number
    - `latency_ms` integer
    - `error_code` string
    - `error` string
    - `output_error` string, nullable
    - `sanitized` boolean
    - `simulated` boolean
    - `zdr` boolean
    - `refund_pending` boolean
    - `created_at` integer
    - `finished_at` integer
    - `payload_state` 'available' | 'not_captured' | 'not_retained' | 'missing' | 'unavailable'
    - `input` unknown
    - `output` unknown
    - `input_truncated` boolean
    - `output_truncated` boolean
    - `input_bytes` integer
    - `output_bytes` integer

## Other responses

- `404`: A Tools error. Branch on `code`. Refusals from the authentication layer have no `success` or `code`; see [Errors](/agent-infra/tools/errors).

## Changes

- **2026-11-03** `80ba8288c51d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orcarouter/apis/orcarouter-api/changes/tools/runs/:run_id/get.md)

---

[API](https://skmtc.dev/orcarouter/apis/orcarouter-api.md) - [All operations](https://skmtc.dev/orcarouter/apis/orcarouter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orcarouter/apis/orcarouter-api/revisions/80ba8288c51d?raw)