Sign in
Sessions

List sessions

List all sessions — reports, systematic reviews, and research-agent sessions — for the authenticated user in a single feed, ordered by creation date (newest first).

Each item carries its sessionId, a type field (report, systematicReview, or agent), and a links object with the URLs for the item's follow-up requests: links.self is the typed get endpoint for its full status and results, and links.resume appears only while the session is paused for insufficient quota. Agent items omit executionStage (agent sessions have no pipeline stages); for them status: "completed" means idle and awaiting input rather than terminally finished.

Results are paginated using cursor-based pagination. Use the nextCursor value from the response to fetch the next page. Filters apply to all session types; pass type to list a single kind.

Example

# First page
curl https://elicit.com/api/v2/sessions?limit=10 \
  -H "Authorization: Bearer elk_live_your_key_here"

# Next page
curl "https://elicit.com/api/v2/sessions?limit=10&cursor=2025-06-15T14:30:00.000Z_5ad08bfb-cbe0-4911-a8c3-309760d33029" \
  -H "Authorization: Bearer elk_live_your_key_here"

# Only reports created via the API
curl "https://elicit.com/api/v2/sessions?type=report&source=api" \
  -H "Authorization: Bearer elk_live_your_key_here"
get/sessions

Query parameters

limitinteger

Maximum number of sessions to return (default: 20, max: 100)

Example:20

Maximum number of sessions to return (default: 20, max: 100)

cursorstring

Opaque pagination cursor from a previous response's nextCursor field. Omit for the first page.

Example:2025-06-15T14:30:00.000Z_5ad08bfb-cbe0-4911-a8c3-309760d33029

Opaque pagination cursor from a previous response's nextCursor field. Omit for the first page.

source'user' | 'api' | 'mcp' | 'agent_session'

Filter by how the session was created

Example:api

Filter by how the session was created

type'report' | 'systematicReview' | 'agent'

Filter to a single session type

Example:report

Filter to a single session type

status'processing' | 'pausedForInsufficientQuota' | 'completed' | 'failed' | 'unknown'

Filter by session status

Example:completed

Filter by session status

Response

List of sessions.

nextCursorstring nullable required

Opaque cursor for the next page; pass it back as cursor. Null if there are no more results.

Example response

{
  "sessions": [
    {
      "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "title": "What are the effects of GLP-1 receptor agonists on cardiovascular outcomes?",
      "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "source": "api",
      "createdAt": "2025-06-15T14:30:00.000Z",
      "links": {
        "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
        "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
      }
    }
  ],
  "nextCursor": "2025-06-15T14:30:00.000Z_5ad08bfb-cbe0-4911-a8c3-309760d33029"
}

Changes