Skip to main content
GET
List an exam's candidates

Authorizations

X-API-Key
string
header
required

Your institute's API key, vak_eval_ followed by 48 hex characters. An institute admin creates keys in the dashboard under Settings -> Integrations -> API keys.

Path Parameters

examId
string<uuid>
required

Exam id (UUID).

Query Parameters

limit
integer
default:50

Page size, 1-200. Default 50.

Required range: 1 <= x <= 200
cursor
string

next_cursor from the previous page, passed as is.

updated_since
string<date-time>

ISO 8601 UTC time, e.g. 2026-10-01T09:00:00Z. Only rows updated since then.

Example:

"2026-10-01T09:00:00Z"

Response

OK

data
object[]
next_cursor
string | null

Pass as cursor to get the next page.

has_more
boolean