Skip to main content
GET
/
v0
/
monitors
/
{monitor}
/
runs
/
{id}
cURL
curl --request GET \
  --url https://api.exa.ai/websets/v0/monitors/{monitor}/runs/{id} \
  --header 'x-api-key: <api-key>'
# pip install exa-py
from exa_py import Exa

exa = Exa("YOUR_EXA_API_KEY")

run = exa.websets.monitors.runs.get("monitor_id", "run_id")

print(f"Monitor run: {run.id} - {run.status}")
// npm install exa-js
import Exa from "exa-js";
const exa = new Exa("YOUR_EXA_API_KEY");

const run = await exa.websets.monitors.runs.get("monitor_id", "run_id");

console.log(`Monitor run: ${run.id} - ${run.status}`);
{
  "id": "<string>",
  "object": "monitor_run",
  "monitorId": "<string>",
  "completedAt": "2023-11-07T05:31:56Z",
  "failedAt": "2023-11-07T05:31:56Z",
  "failedReason": "<string>",
  "canceledAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

x-api-key
string
header
required

Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .

Path Parameters

monitor
string
required

The id of the Monitor to get the run for

id
string
required

Response

200 - application/json

Monitor run details

id
string
required

The unique identifier for the Monitor Run

object
enum<string>
required

The type of object

Available options:
monitor_run
status
enum<string>
required

The status of the Monitor Run

Available options:
created,
running,
completed,
canceled,
failed
monitorId
string
required

The monitor that the run is associated with

type
enum<string>
required

The type of the Monitor Run

Available options:
search,
refresh
completedAt
string<date-time> | null
required

When the run completed

failedAt
string<date-time> | null
required

When the run failed

failedReason
string | null
required

The reason the run failed

canceledAt
string<date-time> | null
required

When the run was canceled

createdAt
string<date-time>
required

When the run was created

updatedAt
string<date-time>
required

When the run was last updated