---
title: "Get a Run"
method: GET
path: "/monitors/{id}/runs/{runId}"
tags: ["Runs"]
---

# Get a Run

`GET /monitors/{id}/runs/{runId}`

Retrieves a single run by its ID, including the full output if the run is completed.

## Path parameters

- `id` string, required — The monitor ID
- `runId` string, required — The run ID

## Response `200`

The run

- SearchMonitorRun
  - `id` string, required — The unique identifier for the run
  - `monitorId` string, required — The monitor this run belongs to
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'cancelled', required — The status of the run
  - `output` SearchMonitorRunOutput, required
    - `results` object[], nullable — The search results
    - `content` union — Any JSON value.
      - boolean
      - number
      - string
      - JsonValue[]
      - object
    - `grounding` object[], nullable — Field-level citations with confidence levels
      - `field` string, required — The output field this citation applies to
      - `citations` object[], required
        - `url` string, uri, required — Source URL.
        - `title` string, required — Source title.
      - `confidence` 'low' | 'medium' | 'high', required — Model-reported reliability for this field.
  - `failReason` 'api_key_invalid' | 'insufficient_credits' | 'invalid_params' | 'rate_limited' | 'source_not_available' | 'forbidden' | 'search_unavailable' | 'search_failed' | 'internal_error', nullable, required — The reason the run failed. Null unless status is `failed`. `source_not_available` means the search requested a domain Exa cannot return (remove it from the search), and `forbidden` means the request was otherwise not permitted.
  - `startedAt` string, date-time, nullable, required — When the run started executing
  - `completedAt` string, date-time, nullable, required — When the run completed successfully
  - `failedAt` string, date-time, nullable, required — When the run failed
  - `cancelledAt` string, date-time, nullable, required — When the run was cancelled
  - `durationMs` integer, nullable, required — Total execution time in milliseconds
  - `createdAt` string, date-time, required — When the run was created
  - `updatedAt` string, date-time, required — When the run was last updated

---

[API](https://skmtc.net/exa/apis/exa-public-api.md) · [All operations](https://skmtc.net/exa/apis/exa-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/exa/exa-public-api/revisions/982a352e3781/schema)