Skip to main content
GET
/
agent
/
runs
cURL
curl -s "https://api.exa.ai/agent/runs?limit=10" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Exa-Beta: agent-2026-05-07"
{
  "object": "<string>",
  "data": [
    {
      "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
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8"
}

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.
Runs are returned from newest to oldest. Use limit to control page size and cursor with the nextCursor from the previous response to fetch the next page.

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

Query Parameters

​
limit
integer
default:20

Number of items to return. Defaults to 20.

Required range: 1 <= x <= 100
​
cursor
string

Cursor for pagination. Use the nextCursor value from the previous run list response. 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

Paginated Agent runs

​
object
string
required
Allowed value: "list"
​
data
object[]
required
​
hasMore
boolean
required
​
nextCursor
string | null
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"