Skip to main content
GET
/
search-monitors
/
{id}
/
runs
/
{runId}
Get a Run
curl --request GET \
  --url https://api.exa.ai/search-monitors/{id}/runs/{runId} \
  --header 'x-api-key: <api-key>'
{
  "id": "<string>",
  "object": "search_monitor_run",
  "monitorId": "<string>",
  "status": "pending",
  "output": {
    "results": [
      {}
    ],
    "content": "<unknown>",
    "grounding": [
      {
        "field": "<string>",
        "citations": [
          {
            "url": "<string>",
            "title": "<string>"
          }
        ],
        "confidence": "low"
      }
    ]
  },
  "failReason": "api_key_invalid",
  "startedAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "failedAt": "2023-11-07T05:31:56Z",
  "cancelledAt": "2023-11-07T05:31:56Z",
  "durationMs": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

The monitor ID

​
runId
string
required

The run ID

Response

The run

​
id
string
required

The unique identifier for the run

​
object
enum<string>
required

The type of object

Available options:
search_monitor_run
​
monitorId
string
required

The monitor this run belongs to

​
status
enum<string>
required

The status of the run

Available options:
pending,
running,
completed,
failed,
cancelled
​
output
object
required

The output of the run. Null until the run completes.

​
failReason
enum<string> | null
required

The reason the run failed. Null unless status is failed.

Available options:
api_key_invalid,
insufficient_credits,
invalid_params,
rate_limited,
search_unavailable,
search_failed,
internal_error
​
startedAt
string<date-time> | null
required

When the run started executing

​
completedAt
string<date-time> | null
required

When the run completed successfully

​
failedAt
string<date-time> | null
required

When the run failed

​
cancelledAt
string<date-time> | null
required

When the run was cancelled

​
durationMs
integer | null
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