---
title: "Read a script run's result by run_id."
method: GET
path: "/v1/runs/{id}"
---

# Read a script run's result by run_id.

`GET /v1/runs/{id}`

## Request

- Base URL: `http://127.0.0.1:10108`
- URL: `http://127.0.0.1:10108/v1/runs/{id}`
- Auth: HTTP bearer

Returns a run's state and, per profile, whether it finished, its exit code and the tail of the script's output. Poll it until `status` is no longer `running`.

## Path parameters

- `id` string, required

## Response `200`

The run and, once each profile finishes, its outcome with the tail of the script's output.

- object
  - `completedAt` string, date-time, nullable, required
  - `error` string, nullable, required
  - `id` string, uuid, required
  - `profileIds` string[], required
  - `profiles` object[], required
    - `elapsedMs` integer, required
    - `error` string, nullable, required
    - `exitCode` integer, nullable, required
    - `profileId` string, uuid, required
    - `status` 'completed' | 'failed', required
    - `stderrTail` string, required
    - `stdoutTail` string, required
  - `profilesDone` integer, required
  - `profilesFailed` integer, required
  - `profilesTotal` integer, required
  - `scheduleId` string, uuid, nullable, required
  - `scriptId` string, uuid, nullable, required
  - `source` 'schedule' | 'app' | 'agent' | 'null', nullable, required
  - `startedAt` string, date-time, required
  - `status` 'running' | 'completed' | 'partial' | 'failed' | 'skipped', required

## Other responses

- `400`: The id is not a uuid.
- `401`: No bearer token, or not a token this app issued. The body is empty: it never says which.
- `403`: Refused by the plan: it no longer includes the local API (checked on every request), or it does not allow this action (profile or schedule limit, parallel runs). A request whose Host header is not loopback is also 403, with an empty body.
- `404`: No run with this id.
- `500`: Veilus failed: storage could not be read or written, or a task panicked. The message says what failed; retrying rarely helps.

---

[API](https://skmtc.dev/veilus/apis/veilus-local-api.md) · [All operations](https://skmtc.dev/veilus/apis/veilus-local-api/llms.txt) · [OpenAPI document](https://skmtc.dev/veilus/apis/veilus-local-api/revisions/67ac3818f9d2?raw)