Scores - OnlookAI

Get current score

GET /v1/sessions/:id/score

Response

{
  "sessionId": "sess_8xK2mP9q",
  "score": 94,
  "updatedAt": "2026-04-28T14:46:21Z"
}

Score history

GET /v1/sessions/:id/scores

Returns the score at each point in the session, useful for charting attention over time. Response

{
  "sessionId": "sess_8xK2mP9q",
  "history": [
    { "score": 88, "timestamp": "2026-04-28T14:32:08Z" },
    { "score": 76, "timestamp": "2026-04-28T14:33:10Z" },
    { "score": 94, "timestamp": "2026-04-28T14:34:05Z" }
  ]
}

Aggregate scores

GET /v1/scores

Query parameters

Param	Type	Description
`groupBy`	string	`page`, `cohort`, `userId`
`metric`	string	`avg`, `p50`, `p95`
`window`	string	`1h`, `24h`, `7d`, `30d`

Response

{
  "groups": [
    { "key": "/dashboard", "avg": 81, "p50": 84, "sessions": 412 },
    { "key": "/onboarding", "avg": 62, "p50": 65, "sessions": 98 }
  ]
}