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>",
      "createdAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z",
      "request": {
        "query": "What are the most important AI infrastructure funding rounds announced this week?",
        "systemPrompt": "Prefer official sources and avoid duplicate results.",
        "input": {
          "data": [
            {}
          ],
          "exclusion": [
            {}
          ]
        },
        "outputSchema": {},
        "effort": "auto",
        "previousRunId": "agent_run_01j7x9v0m2n4p6q8r0s2t4v6w8",
        "metadata": {
          "slack_channel_id": "C123ABC",
          "slack_thread_id": "1745444400.123456",
          "user_id": "U123ABC"
        }
      },
      "output": {
        "text": "<string>",
        "structured": true,
        "grounding": [
          {
            "field": "structured.companies[0].sourceUrl",
            "citations": [
              {
                "url": "<string>",
                "title": "<string>"
              }
            ],
            "score": 0.5
          }
        ]
      },
      "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

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

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 results per page

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

Cursor for pagination. Use the nextCursor value from the previous run list response.

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

Whether there are more results

​
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"