Skip to main content
The Session API gives REST access to a Proctoring v8 session: the session itself, its chronological timeline, and the incidents raised during it, including the events behind each incident.

Conventions

  • Base URL. https://api.talview.com
  • GET only. The endpoint is a read and takes no request body.
  • Bearer authentication. Send an access token in the Authorization header. See Authentication.
  • Automatic tenant isolation. The tenant comes from the token. Never send a tenant_id parameter. A session that belongs to another tenant is reported as not found.
  • UTC timestamps in ISO 8601 format throughout.

Get a session

GET /api/rest/sessions/{uuid} Fetches one session by its Talview-issued UUID. Store the uuid returned for each session and use it as your reference: sessions cannot be looked up by an external candidate identifier.

Path parameters

Response

Field notes

Errors

Session statuses

CREATED, IN_PROGRESS, PAUSED, STOPPED, SUSPENDED, COMPLETED, TERMINATED