Analytics Overview

GET

analytics

overview

curl https://api.promptster.ai/v1/analytics/overview \
  -H "Authorization: Bearer sk_live_abc123def456"

{
  "summary": {
    "totalCandidates": 47,
    "completionRate": 0.83,
    "avgTimeMinutes": 52.3,
    "passRate": 0.71
  },
  "funnel": [
    { "label": "invited", "count": 47, "pct": 100 },
    { "label": "started", "count": 42, "pct": 89.4 },
    { "label": "completed", "count": 39, "pct": 83.0 }
  ],
  "weeklyCompletions": [
    { "week": "2026-W13", "count": 8 },
    { "week": "2026-W14", "count": 12 }
  ],
  "trends": {
    "completionRateChange": 0.05,
    "avgTimeChange": -3.2,
    "passRateChange": 0.02
  },
  "strategyTierDistribution": {
    "strong": 12,
    "adequate": 18,
    "developing": 6,
    "insufficient": 3,
    "total": 39
  },
  "testPassRate": 0.71,
  "avgPromptCount": 14.2,
  "sessionMetrics": {
    "avgFirstChangeLatencyMs": 95000,
    "avgVerifyIntensity": 2.1,
    "avgErrorEpisodes": 1.3,
    "totalPrompts": 554,
    "totalCommands": 312,
    "totalFileDiffs": 189
  },
  "topTools": [
    { "toolName": "Edit", "count": 342 },
    { "toolName": "Bash", "count": 287 },
    { "toolName": "Read", "count": 201 }
  ]
}

Returns aggregate metrics including completion rates, weekly trends, strategy tier distribution, and session-level statistics. Useful for building dashboards or tracking hiring pipeline health.

Authentication

Requires a Clerk JWT (dashboard users only).

Authorization: Bearer sk_live_...

object

High-level counts and rates.

Show properties

integer

Total candidates across all assessments.

number

Fraction of candidates who completed (0–1).

number

Average session duration in minutes.

number

Fraction of completed sessions that passed tests (0–1).

array

Assessment funnel stages with counts and percentages.

Show properties

string

Funnel stage name (e.g. invited, started, completed).

integer

Number of candidates at this stage.

number

Percentage of total (0–100).

array

Completions grouped by ISO week.

Show properties

string

ISO week label (e.g. 2026-W14).

integer

Sessions completed that week.

object

Week-over-week changes.

Show properties

number

Change in completion rate vs. prior week.

number

Change in average time vs. prior week.

number

Change in pass rate vs. prior week.

object | null

Distribution of candidates across strategy tiers (from prompt analysis).

Show properties

integer

Candidates rated “strong”.

integer

Candidates rated “adequate”.

integer

Candidates rated “developing”.

integer

Candidates rated “insufficient”.

integer

Total rated candidates.

number

Overall test pass rate across all sessions.

number

Average number of prompts per session.

object | null

Aggregate session-level metrics.

Show properties

number | null

Average time to first code change in milliseconds.

number

Average verification intensity score.

number

Average error recovery episodes per session.

integer

Total prompts across all sessions.

integer

Total commands across all sessions.

integer

Total file diffs across all sessions.

array

Most frequently used tools across all sessions.

Show properties

string

Tool name (e.g. Edit, Write, Bash).

integer

Total invocations.

{
  "summary": {
    "totalCandidates": 47,
    "completionRate": 0.83,
    "avgTimeMinutes": 52.3,
    "passRate": 0.71
  },
  "funnel": [
    { "label": "invited", "count": 47, "pct": 100 },
    { "label": "started", "count": 42, "pct": 89.4 },
    { "label": "completed", "count": 39, "pct": 83.0 }
  ],
  "weeklyCompletions": [
    { "week": "2026-W13", "count": 8 },
    { "week": "2026-W14", "count": 12 }
  ],
  "trends": {
    "completionRateChange": 0.05,
    "avgTimeChange": -3.2,
    "passRateChange": 0.02
  },
  "strategyTierDistribution": {
    "strong": 12,
    "adequate": 18,
    "developing": 6,
    "insufficient": 3,
    "total": 39
  },
  "testPassRate": 0.71,
  "avgPromptCount": 14.2,
  "sessionMetrics": {
    "avgFirstChangeLatencyMs": 95000,
    "avgVerifyIntensity": 2.1,
    "avgErrorEpisodes": 1.3,
    "totalPrompts": 554,
    "totalCommands": 312,
    "totalFileDiffs": 189
  },
  "topTools": [
    { "toolName": "Edit", "count": 342 },
    { "toolName": "Bash", "count": 287 },
    { "toolName": "Read", "count": 201 }
  ]
}

curl https://api.promptster.ai/v1/analytics/overview \
  -H "Authorization: Bearer sk_live_abc123def456"

curl https://api.promptster.ai/v1/analytics/overview \
  -H "Authorization: Bearer sk_live_abc123def456"

{
  "summary": {
    "totalCandidates": 47,
    "completionRate": 0.83,
    "avgTimeMinutes": 52.3,
    "passRate": 0.71
  },
  "funnel": [
    { "label": "invited", "count": 47, "pct": 100 },
    { "label": "started", "count": 42, "pct": 89.4 },
    { "label": "completed", "count": 39, "pct": 83.0 }
  ],
  "weeklyCompletions": [
    { "week": "2026-W13", "count": 8 },
    { "week": "2026-W14", "count": 12 }
  ],
  "trends": {
    "completionRateChange": 0.05,
    "avgTimeChange": -3.2,
    "passRateChange": 0.02
  },
  "strategyTierDistribution": {
    "strong": 12,
    "adequate": 18,
    "developing": 6,
    "insufficient": 3,
    "total": 39
  },
  "testPassRate": 0.71,
  "avgPromptCount": 14.2,
  "sessionMetrics": {
    "avgFirstChangeLatencyMs": 95000,
    "avgVerifyIntensity": 2.1,
    "avgErrorEpisodes": 1.3,
    "totalPrompts": 554,
    "totalCommands": 312,
    "totalFileDiffs": 189
  },
  "topTools": [
    { "toolName": "Edit", "count": 342 },
    { "toolName": "Bash", "count": 287 },
    { "toolName": "Read", "count": 201 }
  ]
}

Get Started

Understanding Sessions

Guides

API Reference

Assessments

Keys

Sessions

Candidates

Analytics

Problem Library

Hooks

Branding

Webhooks

Resources

Authentication

​Authentication

Authentication