List Sessions
List sessions for the authenticated organisation.
Ordered by created_at descending (most recently booked first) by default
so a polling integration that reads only the first page catches every new
booking. Pass ?sort=starts_at to order by when the session is scheduled
instead (an agenda view). from/to always filter on starts_at, whichever
sort is used. Filter by status, tutor, student, or date range. Supports
limit/offset and cursor pagination.
Common status values: completed, scheduled, cancelled, pending, time_change_requested, disputed.
Authorizations
Org API key as Token token=ei_live_...
Query Parameters
Filter by status: completed, scheduled, cancelled, pending, etc.
Filter by tutor UUID
Filter by student UUID
starts_at >= this ISO date, e.g. 2026-05-01
starts_at <= this ISO date, e.g. 2026-05-31
Order by: created_at (when booked, newest first - the default) or starts_at (when scheduled, newest first). Applies to offset-mode paging; cursor mode always pages by (created_at, id).
Opaque cursor from a previous response's meta.next_cursor, or the literal 'start' to begin cursor paging from the newest record. When set, offset is ignored and results page by a stable (created_at, id) keyset — recommended for large or incremental syncs.
Records per page (default 20, max 100)
1 <= x <= 100Pagination offset (ignored when cursor is set)
x >= 0Response
Successful Response
Pagination envelope metadata. count is the size of the returned page;
total (when present) is the full result-set size for offset paging.
In cursor mode offset/total are absent and next_cursor carries the
opaque token for the next page (null on the last page).