Analytics
Top Candidates
Retrieve a ranked list of candidates with metrics, test results, and strategy assessments.
GET
/
v1
/
analytics
/
top-candidates
curl https://api.promptster.ai/v1/analytics/top-candidates \
-H "Authorization: Bearer sk_live_abc123def456"
{
"candidates": [
{
"candidateId": "ck_abc123",
"candidateName": "Jane Smith",
"candidateEmail": "[email protected]",
"status": "completed",
"completedAt": "2026-04-07T10:15:00.000Z",
"sessionId": "sess_abc123",
"sourceService": "claude_code",
"assessmentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"assessmentTitle": "React State Management Bug Fix",
"totalCostUsd": 3.42,
"durationMinutes": 48.5,
"testResults": { "passed": 12, "failed": 0, "total": 12 },
"metrics": {
"promptCount": 18,
"commandCount": 24,
"fileDiffCount": 9,
"verifyIntensity": 2.5,
"commandFailRate": 0.08,
"manualEditRatio": 0.35,
"firstChangeLatencyMs": 120000,
"errorEpisodes": 1
},
"strategyTier": "strong",
"trajectoryNarrative": "Methodically traced the bug, verified each fix with tests before moving on.",
"processDescriptors": ["methodical", "test-driven", "iterative"]
}
]
}
Returns all candidates across your organization with their session metrics, test results, strategy tier, and AI-generated process descriptors. Useful for building leaderboards or comparing candidates across assessments.
Authentication
Requires a Clerk JWT (dashboard users only).Authorization: Bearer sk_live_...
array
List of candidate objects ranked by recency.
Show properties
Show properties
string
Candidate key ID.
string | null
Name provided during consent.
string | null
Email provided during consent.
string
Key status (
pending, active, completed, expired).string | null
ISO 8601 completion timestamp.
string | null
Linked session ID.
string | null
Tool used (e.g.
claude_code, cursor).string | null
Assessment ID.
string | null
Assessment title.
number | null
Total LLM token cost in USD.
number | null
Session duration in minutes.
object | null
object
Session-level behavioral metrics.
Show properties
Show properties
integer | null
Total prompts sent.
integer | null
Total terminal commands.
integer | null
Total file changes.
number | null
How often the candidate verified AI output.
number | null
Fraction of commands that failed (0–1).
number | null
Fraction of edits made manually vs. AI-generated (0–1).
number | null
Time to first code change in milliseconds.
integer | null
Number of error recovery episodes.
string | null
AI-assessed strategy tier (
strong, adequate, developing, insufficient).string | null
AI-generated one-line summary of the candidate’s approach.
string[]
Short labels describing the candidate’s working style (e.g.
iterative, test-driven).{
"candidates": [
{
"candidateId": "ck_abc123",
"candidateName": "Jane Smith",
"candidateEmail": "[email protected]",
"status": "completed",
"completedAt": "2026-04-07T10:15:00.000Z",
"sessionId": "sess_abc123",
"sourceService": "claude_code",
"assessmentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"assessmentTitle": "React State Management Bug Fix",
"totalCostUsd": 3.42,
"durationMinutes": 48.5,
"testResults": { "passed": 12, "failed": 0, "total": 12 },
"metrics": {
"promptCount": 18,
"commandCount": 24,
"fileDiffCount": 9,
"verifyIntensity": 2.5,
"commandFailRate": 0.08,
"manualEditRatio": 0.35,
"firstChangeLatencyMs": 120000,
"errorEpisodes": 1
},
"strategyTier": "strong",
"trajectoryNarrative": "Methodically traced the bug, verified each fix with tests before moving on.",
"processDescriptors": ["methodical", "test-driven", "iterative"]
}
]
}
curl https://api.promptster.ai/v1/analytics/top-candidates \
-H "Authorization: Bearer sk_live_abc123def456"
curl https://api.promptster.ai/v1/analytics/top-candidates \
-H "Authorization: Bearer sk_live_abc123def456"
{
"candidates": [
{
"candidateId": "ck_abc123",
"candidateName": "Jane Smith",
"candidateEmail": "[email protected]",
"status": "completed",
"completedAt": "2026-04-07T10:15:00.000Z",
"sessionId": "sess_abc123",
"sourceService": "claude_code",
"assessmentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"assessmentTitle": "React State Management Bug Fix",
"totalCostUsd": 3.42,
"durationMinutes": 48.5,
"testResults": { "passed": 12, "failed": 0, "total": 12 },
"metrics": {
"promptCount": 18,
"commandCount": 24,
"fileDiffCount": 9,
"verifyIntensity": 2.5,
"commandFailRate": 0.08,
"manualEditRatio": 0.35,
"firstChangeLatencyMs": 120000,
"errorEpisodes": 1
},
"strategyTier": "strong",
"trajectoryNarrative": "Methodically traced the bug, verified each fix with tests before moving on.",
"processDescriptors": ["methodical", "test-driven", "iterative"]
}
]
}