Sessions

List a subject's sessions

GET https://api.129.212.147.181.sslip.io/v1/sessions

The sessions of the subject in Docgen-Subject, newest first. There is no call that lists across subjects.

Query parameters

status enum optional
One of active, closed
limit integer optional default 20
Page size, 1–100.
starting_after string optional
A session ID from the previous page; returns the sessions created before it.

Headers

Authorization string required
Bearer dg_test_… or Bearer dg_live_…
Docgen-Subject string optional
Your reference for the end user (a user ID, a hash; never an email). A session is bound to the subject it was created with, and every call on it must send the same value or it is 404. Set it from your own login, never from what the browser sent. Required to create and list sessions unless your organisation has subjects turned off.

Returns

200 OK: a SessionList object. One page of sessions.

Errors

StatusCodeWhat to do
422subject_requiredSend Docgen-Subject.

Any endpoint can also return the common errors (bad key, rate limit, idempotency).