List tasks

Retrieve a paginated list of your research tasks.

The response follows a cursor-based pagination pattern. Pass the limit parameter to control page size (max 50) and use the cursor token returned in the response to fetch subsequent pages.

GET /research/v1

cURL

cURL

curl -X GET 'https://api.exa.ai/research/v1?limit=10' \
  -H 'x-api-key: YOUR-EXA-API-KEY'

200

{
  "data": [
    {
      "researchId": "01jszdfs0052sg4jc552sg4jc5",
      "model": "exa-research",
      "instructions": "What species of ant are similar to honeypot ants?",
      "status": "running"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

The Research API (/research/v1) is being deprecated on May 1, 2026. Migrate to /search with type: "deep-reasoning" for equivalent functionality. See the deprecation notice for details.

Get your Exa API key

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

cursor · string

The cursor to paginate through the results

Minimum string length: 1

limit · number · default: 10

Number of results per page (1-50)

Required range: 1 <= x <= 50

Response

200 - application/json

List of research requests

data · (Pending · object | Running · object | Completed · object | Canceled · object | Failed · object)[] · required

Research requests ordered by creation time (newest first)

Pending

Running

Completed

Canceled

Failed

Show child attributes

Example:

{
  "researchId": "01jszdfs0052sg4jc552sg4jc5",
  "model": "exa-research",
  "instructions": "What species of ant are similar to honeypot ants?",
  "status": "running"
}

hasMore · boolean · required

If true, use nextCursor to fetch more results

nextCursor · string | null · required

Pass this value as the cursor parameter to fetch the next page