Skip to content

Web research runs on the account, newest first, with status.

List Agent runs for your team, ordered from newest to oldest.

Job web.research.list

Your AI asks

checks the price first
telipot run exa.web.research.list \
  --input-json '{"limit":1}' \
  --quote

Price

Price unknown
Priced· before it runs

exa.web.research.list

Price unknownYour plan

Whose account it uses

1The person asking
not needed
2Your company’s Exa plan
Selected identity for this example
3Our account
not used

What it sends

{
  "limit": 1
}

Your Exa login is added for you. Your AI never sees it.

What it costs

Unknown

not listed, never free

sourcedocs · exa.ai/docs/admin/pricing · checked 2026-10-05
confidenceunknown
noteThe pricing page lists no rate for listing runs; the billing page says only that reads of run lists do not count against QPS.

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

telipot run exa.web.research.list \
  --input-json '{"limit":1}'

limit

integer · 1 to 100 · default 20

Number of results per page.

cursor

string · 1 to 200

Where to resume, the nextCursor of the previous page.

object

string

data

object[]

hasMore

boolean

nextCursor

string | null

Pass as cursor to read the next page
Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "object",
  "required": [
    "object",
    "data",
    "hasMore",
    "nextCursor"
  ],
  "properties": {
    "object": {
      "type": "string"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "object",
          "status",
          "stopReason",
          "createdAt",
          "completedAt",
          "request",
          "output",
          "usage",
          "costDollars"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Run id with the agent_run_ prefix"
          },
          "object": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "queued, running, completed, failed or cancelled"
          },
          "stopReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Why the run stopped; null while it is queued or running"
          },
          "createdAt": {
            "type": "string"
          },
          "completedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "request": {
            "type": [
              "object",
              "null"
            ],
            "description": "The request fields stored with the run"
          },
          "output": {
            "type": "object",
            "required": [
              "text",
              "structured",
              "grounding"
            ],
            "properties": {
              "text": {
                "type": "string",
                "description": "Natural-language answer or summary"
              },
              "structured": {
                "description": "JSON shaped by outputSchema; null when no schema was given"
              },
              "grounding": {
                "type": "array",
                "description": "Field-level citations",
                "items": {
                  "type": "object",
                  "required": [
                    "field",
                    "citations"
                  ],
                  "properties": {
                    "field": {
                      "type": "string"
                    },
                    "citations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "confidence": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "usage": {
            "type": "object",
            "required": [
              "agentComputeUnits",
              "searches",
              "emails",
              "phoneNumbers"
            ],
            "properties": {
              "agentComputeUnits": {
                "type": "number"
              },
              "searches": {
                "type": "integer"
              },
              "emails": {
                "type": "integer"
              },
              "phoneNumbers": {
                "type": "integer"
              },
              "dataSources": {
                "type": "object"
              }
            }
          },
          "costDollars": {
            "type": "object",
            "required": [
              "total",
              "agentCompute",
              "search",
              "emails",
              "phoneNumbers"
            ],
            "properties": {
              "total": {
                "type": "number"
              },
              "agentCompute": {
                "type": "number"
              },
              "search": {
                "type": "number"
              },
              "emails": {
                "type": "number"
              },
              "phoneNumbers": {
                "type": "number"
              },
              "dataSources": {
                "type": "object"
              }
            }
          }
        }
      }
    },
    "hasMore": {
      "type": "boolean"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pass as cursor to read the next page"
    }
  }
}

A real answer

examples/exa.web.research.list.json

{
  "object": "masked",
  "data": [
    {
      "id": "masked",
      "object": "masked",
      "status": "masked",
      "stopReason": null,
      "createdAt": "masked",
      "completedAt": null,
      "request": {},
      "output": {
        "text": "masked",
        "structured": null,
        "grounding": []
      },
      "usage": {
        "agentComputeUnits": 0,
        "searches": 3,
        "emails": 0,
        "phoneNumbers": 0
      },
      "costDollars": {
        "total": 0.012,
        "agentCompute": 0,
        "search": 0.012,
        "emails": 0,
        "phoneNumbers": 0
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "masked"
}