Skip to main content
GET
/
agent
/
runs
/
{id}
cURL
curl -s "https://api.exa.ai/agent/runs/agent_run_01j..." \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Exa-Beta: agent-2026-05-07"
{
  "id": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
  "object": "<string>",
  "status": "queued",
  "stopReason": "schema_satisfied",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z",
  "request": {
    "query": "<string>",
    "systemPrompt": "<string>",
    "input": {
      "data": [
        {}
      ],
      "exclusion": [
        {}
      ]
    },
    "outputSchema": {},
    "effort": "auto",
    "previousRunId": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
    "metadata": {}
  },
  "output": {
    "text": "<string>",
    "structured": true,
    "grounding": [
      {
        "field": "structured.companies[0].sourceUrl",
        "citations": [
          {
            "url": "<string>",
            "title": "<string>"
          }
        ],
        "score": 0.5,
        "confidence": "high"
      }
    ]
  },
  "usage": {
    "agentComputeUnits": 1,
    "searches": 1,
    "emails": 1,
    "phoneNumbers": 1
  },
  "costDollars": {
    "total": 1,
    "agentCompute": 1,
    "search": 1,
    "emails": 1,
    "phoneNumbers": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://exa.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Exa Agent is in beta. It requires Exa-Beta: agent-2026-05-07 on every request.
Use this endpoint to poll a run until it reaches completed, failed, or cancelled.

Get your Exa API key

Authorizations

​
x-api-key
string
header
required

Your Exa API key.

Headers

​
Exa-Beta
enum<string>
required

Required beta token for the Agent.

Available options:
agent-2026-05-07

Path Parameters

​
id
string
required

Agent run ID. Agent run ID. New run IDs are returned with the agent_run_ prefix.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_.:-]+$
Example:

"agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8"

Response

Agent run

​
id
string
required

Agent run ID. New run IDs are returned with the agent_run_ prefix.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_.:-]+$
Example:

"agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8"

​
object
string
required
Allowed value: "agent_run"
​
status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
cancelled
​
stopReason
enum<string> | null
required

Why the run stopped. null while the run is queued or running.

Available options:
schema_satisfied,
budget_reached,
error,
cancelled
​
createdAt
string<date-time>
required
​
completedAt
string<date-time> | null
required
​
request
object
required

Canonicalized request fields stored with the run.

​
output
object
required
​
usage
object
required
​
costDollars
object
required