List Agent runs

Retrieve a paginated list of Agent runs for your team.

cURL

cURL

curl -X GET https://api.exa.ai/agent/runs \
  -H "x-api-key: $EXA_API_KEY"

200

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "agent_run",
      "status": "queued",
      "stopReason": "schema_satisfied",
      "createdAt": "2023-11-07T05:31:56Z",
      "completedAt": "2023-11-07T05:31:56Z",
      "request": {
        "query": "<string>",
        "systemPrompt": "<string>",
        "effort": "auto",
        "input": {
          "data": [
            {}
          ],
          "exclusion": [
            {}
          ]
        },
        "outputSchema": {},
        "previousRunId": "<string>",
        "metadata": {},
        "dataSources": [
          {
            "provider": "<string>"
          }
        ],
        "budget": {
          "maxCostDollars": 123,
          "maxDurationSeconds": 123
        }
      },
      "error": {
        "type": "INVALID_REQUEST",
        "code": "INVALID_REQUEST",
        "message": "<string>"
      },
      "output": {
        "text": "<string>",
        "structured": true,
        "grounding": [
          {
            "field": "<string>",
            "citations": [
              {
                "url": "<string>",
                "title": "<string>"
              }
            ],
            "confidence": "low"
          }
        ]
      },
      "usage": {
        "agentComputeUnits": 1,
        "searches": 1,
        "emails": 1,
        "phoneNumbers": 1,
        "dataSources": {}
      },
      "costDollars": {
        "total": 1,
        "agentCompute": 1,
        "search": 1,
        "emails": 1,
        "phoneNumbers": 1,
        "dataSources": {}
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

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

Create a key in the dashboard. New accounts start with free credits.

Authorizations

apiKeybearer

x-api-key · string · header · required

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

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_.:-]+$

Response

200

application/json

Paginated Agent runs

object · string · required

Allowed value: "list"

data · object[] · required

Show child attributes

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_.:-]+$