# exa.web.research.list

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

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

Page: https://telipot.com/catalog/tasks/exa.web.research.list · Markdown: https://telipot.com/catalog/tasks/exa.web.research.list/md · JSON: https://telipot.com/catalog/tasks/exa.web.research.list/json

| Field | Value |
| --- | --- |
| provider | [Exa](https://telipot.com/catalog/providers/exa) `exa` |
| capability | [`web.research.list`](https://telipot.com/catalog/capabilities/web.research.list) |
| kind | account |
| tier | core |
| price | Price unknown (Not listed, not free) |
| price note | The pricing page lists no rate for listing runs; the billing page says only that reads of run lists do not count against QPS. |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `GET https://api.exa.ai/agent/runs` |
| verification | Verified on 2026-10-05. We ran a real request and checked the answer. This is a spot check, not a success rate. |
| status | live |
| docs | https://exa.ai/docs/reference/agent-api/list-runs |

## Preview the price · nothing runs

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

## Run it

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

```bash
curl https://api.telipot.com/v1/tasks/exa.web.research.list/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"limit":1}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `limit` | queryParams | integer | no | 1 to 100; default 20 | Number of results per page. |
| `cursor` | queryParams | string | no | 1 to 200 | Where to resume, the nextCursor of the previous page. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Number of results per page.",
      "default": 20,
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string",
      "description": "Where to resume, the nextCursor of the previous page.",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "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"
    }
  }
}
```

## Example response

From `examples/exa.web.research.list.json`.

```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"
}
```