List Sessions

GET

sessions

curl "https://api.promptster.ai/v1/sessions?limit=20&offset=0&sourceService=claude_code" \
  -H "Authorization: Bearer psk_live_abc123def456"

{
  "sessions": [
    {
      "id": "sess_abc123",
      "orgId": "org_2abc123",
      "sourceService": ["claude_code"],
      "startedAt": "2026-04-07T09:00:00.000Z",
      "endedAt": "2026-04-07T10:15:00.000Z",
      "lastActivityAt": "2026-04-07T10:14:30.000Z",
      "metadata": {},
      "eventCount": 142,
      "decisionFlagCount": 3,
      "aiAttributionPct": 72.5,
      "totalCostUsd": 3.42,
      "createdAt": "2026-04-07T09:00:00.000Z",
      "updatedAt": "2026-04-07T10:15:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Returns a paginated list of sessions ordered by most recent activity. You can filter by source service (e.g. claude_code, cursor) or by assessment ID.

Authentication

Requires either an org API key or a candidate key.

Authorization: Bearer psk_live_...

integer

default:"20"

Number of sessions to return. Maximum 100.

integer

default:"0"

Number of sessions to skip for pagination.

string

Filter by source service (e.g. claude_code, cursor).

string

Filter to sessions linked to a specific assessment.

array

List of session objects.

Show properties

string

Session ID.

string

Organization ID.

string[]

Source services (e.g. ["claude_code"]).

string | null

When the session started.

string | null

When the session ended.

string | null

Last event timestamp.

object

Session metadata.

integer

Total number of timeline events.

integer

Number of flagged decisions.

number | null

Percentage of code attributed to AI.

number

Total LLM token cost in USD.

string

ISO 8601 creation timestamp.

string

ISO 8601 last update timestamp.

integer

Total number of matching sessions.

integer

The limit used for this request.

integer

The offset used for this request.

{
  "sessions": [
    {
      "id": "sess_abc123",
      "orgId": "org_2abc123",
      "sourceService": ["claude_code"],
      "startedAt": "2026-04-07T09:00:00.000Z",
      "endedAt": "2026-04-07T10:15:00.000Z",
      "lastActivityAt": "2026-04-07T10:14:30.000Z",
      "metadata": {},
      "eventCount": 142,
      "decisionFlagCount": 3,
      "aiAttributionPct": 72.5,
      "totalCostUsd": 3.42,
      "createdAt": "2026-04-07T09:00:00.000Z",
      "updatedAt": "2026-04-07T10:15:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

curl "https://api.promptster.ai/v1/sessions?limit=20&offset=0&sourceService=claude_code" \
  -H "Authorization: Bearer psk_live_abc123def456"

curl "https://api.promptster.ai/v1/sessions?limit=20&offset=0&sourceService=claude_code" \
  -H "Authorization: Bearer psk_live_abc123def456"

{
  "sessions": [
    {
      "id": "sess_abc123",
      "orgId": "org_2abc123",
      "sourceService": ["claude_code"],
      "startedAt": "2026-04-07T09:00:00.000Z",
      "endedAt": "2026-04-07T10:15:00.000Z",
      "lastActivityAt": "2026-04-07T10:14:30.000Z",
      "metadata": {},
      "eventCount": 142,
      "decisionFlagCount": 3,
      "aiAttributionPct": 72.5,
      "totalCostUsd": 3.42,
      "createdAt": "2026-04-07T09:00:00.000Z",
      "updatedAt": "2026-04-07T10:15:00.000Z"
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Get Started

Understanding Sessions

Guides

API Reference

Assessments

Keys

Sessions

Candidates

Analytics

Problem Library

Hooks

Branding

Webhooks

Resources

Authentication

​Authentication

Authentication