---
title: "Get Tool Run Status"
method: GET
path: "/v1beta2/tool/run-status/{tool_run_uid}"
tags: ["Tools"]
---

# Get Tool Run Status

`GET /v1beta2/tool/run-status/{tool_run_uid}`

## Request

- Base URL: `https://api.hunch.tools`
- URL: `https://api.hunch.tools/v1beta2/tool/run-status/{tool_run_uid}`
- Auth: HTTP bearer

This endpoint returns the status of the specified tool run. If the run is
completed, it also returns the outputs of the run.

The status of the run can be one of:
- `RUNNING`: The run is still in progress.
- `COMPLETED`: The run has completed successfully.
- `FAILED`: The run has failed.

The outputs are specified as a list of dictionaries each containing the
title of the output block, the output text, and any files.

## Path parameters

- `tool_run_uid` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ToolRunStatusResponse: The response body returned when checking the status of a tool run.
  - `status` 'RUNNING' | 'COMPLETED' | 'FAILED', required: The status of a tool run.
  - `outputs` ToolRunOutput[], nullable: The outputs of the tool run, if available
    - `title` string, required: The title of the output block in the tool
    - `text` string, nullable, required: The value of the output
    - `files` ToolRunOutputFile[], required: The files contained in the output
      - `uid` string, required: The unique identifier of the file
      - `url` string, required: The URL to download the file (signed URL with expiry)

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `456`: Additional Response

---

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