Skip to main content
GET
List an exam's submissions

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

status
string

Comma-separated statuses: queued, processing, reading, grading, graded, partially_graded, failed, cancelled.

Example:

"graded,partially_graded"

needs_review
enum<string>

true or false.

Available options:
true,
false
finalized
enum<string>

true or false.

Available options:
true,
false
candidate_id
string

Only this candidate's submissions (Evalezy candidate id).

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"

cursor
string

next_cursor from the previous page, passed as is.

limit
integer
default:50

Page size, 1-200. Default 50. Capped at 50 when include=result.

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

result adds the full result to each live submission. Can be combined with annotations, model_answer, -extracted_answer.

Example:

"result"

Response

OK

data
object[]
next_cursor
string | null

Pass as cursor to get the next page.

has_more
boolean