Amba
API ReferenceAdmin API

Sessions

Session analytics (DAU, totals, avg / median duration) and a raw recent-sessions list.

Both endpoints aggregate server-side. DAU is always a 24-hour window regardless of the analytics period.

Source: apps/api/src/routes/admin/sessions.ts.

Endpoints

MethodPathDescription
GET/admin/projects/:projectId/sessionsAggregate analytics for the period.
GET/admin/projects/:projectId/sessions/listPaginated raw sessions, newest first.

GET /admin/projects/:projectId/sessions

Query

ParamDefaultAllowed values
period7d24h, 7d, 30d, 90d

Response 200

{
  "data": {
    "period": "7d",
    "dau": 1234,
    "period_active_users": 5678,
    "total_sessions": 9876,
    "avg_duration_seconds": 312,
    "median_duration_seconds": 180
  }
}

Errors

  • 400 INVALID_PERIOD.
  • 500 FETCH_FAILED.

Try it:

GET/admin/projects/%7B%7BprojectId%7D%7D/sessions
developer auth
curl -X GET 'https://api.amba.dev/admin/projects/%7B%7BprojectId%7D%7D/sessions'
Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/admin/projects/{projectId}/sessions' \
  -H 'Authorization: Bearer ${DEV_TOKEN}'

GET /admin/projects/:projectId/sessions/list

Query

ParamDefault
limit50
offset0

Response 200

{
  "data": [
    { "id": "…", "app_user_id": "…", "started_at": "…", "ended_at": "…", "duration_seconds": 180 }
  ],
  "total": 1234,
  "offset": 0,
  "limit": 50
}

Try it:

GET/admin/projects/%7B%7BprojectId%7D%7D/sessions/list
developer auth
curl -X GET 'https://api.amba.dev/admin/projects/%7B%7BprojectId%7D%7D/sessions/list'
Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/admin/projects/{projectId}/sessions/list' \
  -H 'Authorization: Bearer ${DEV_TOKEN}'

Previous

Roles

Next

Integrations

On this page