ELelicitlabs
Sessions

List sessions

Changed on

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

Request

  • Base URL
    https://elicit.com/api/v2
  • URL
    https://elicit.com/api/v2/sessions
  • Auth
    HTTP bearer

Query parameters

limitinteger

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

Example:20
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
source'user' | 'api' | 'mcp' | 'agent_session'

Filter by how the session was created

Example:api
type'report' | 'systematicReview' | 'agent'

Filter to a single session type

Example:report
status'processing' | 'pausedForInsufficientQuota' | 'completed' | 'failed' | 'unknown'

Filter by session status

Example:completed

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.

totalCountinteger required

Total sessions matching the filters across all pages.

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