API Overview

The OnlookAI REST API for querying sessions, scores, and webhooks.

Base URL

https://api.onlookai.com/v1

For self-hosted deployments, replace with your ingest endpoint (default: http://localhost:4000/v1).

Authentication

All API requests require a Bearer token.

curl https://api.onlookai.com/v1/sessions \
  -H "Authorization: Bearer YOUR_API_KEY"

Generate API keys from the dashboard under Settings → API Keys.

Response format

All responses are JSON. Errors follow this shape:

{
  "error": {
    "code": "session_not_found",
    "message": "No session found with id sess_8xK2mP9q"
  }
}

Rate limits

Plan	Requests/minute
Free	60
Pro	600
Enterprise	Unlimited

Pages

Sessions

List and retrieve session data.

Scores

Query attention scores and history.

Webhooks

Configure and verify webhook delivery.