---
title: "List your runs"
method: GET
path: "/tools/runs"
tags: ["Tools"]
---

# List your runs

`GET /tools/runs`

## Request

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

Your own runs, newest first, without their input or output. A key
sees only the runs made as its own agent.

## Query parameters

- `status` 'running' | 'completed' | 'failed' | 'blocked' | 'voided'
- `tool_id` string
- `page` integer
- `size` integer

## Response `200`

OK

- object
  - `success` boolean
  - `data` object
    - `items` ToolRun[]
      - `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
    - `total` integer
    - `page` integer
    - `size` integer

## Changes

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

[Operation history](https://skmtc.dev/orcarouter/apis/orcarouter-api/changes/tools/runs/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)