Skip to main content
GET
Get quiz report

Authorizations

x-api-key
string
header
required

API key for authentication. Generate keys in the Doozy dashboard.

Path Parameters

quizId
string
required

The unique identifier of the quiz

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]+$
Example:

"quiz_abc123"

Query Parameters

limit
integer
default:25

Maximum number of participants to return (1-10000, default 25)

Required range: 1 <= x <= 10000
Example:

25

starting_after
string

Cursor for pagination - the user ID of the last participant from the previous page

Maximum string length: 256
Example:

"user_abc123"

ending_before
string

Cursor for backward pagination - the user ID of the first participant on the previous page

Maximum string length: 256
Example:

"user_xyz789"

status
enum<string>

Filter participants by status

Available options:
not_started,
in_progress,
completed,
expired
Example:

"completed"

statuses
enum<string>[]

Comma-separated participant statuses. Takes precedence over status.

Minimum array length: 1
Available options:
not_started,
in_progress,
completed,
expired
Example:

"completed,expired"

sort
enum<string>
default:name_asc

Participant order. Score ties use points, duration, name, member ID, then delivery ID.

Available options:
score_desc,
score_asc,
name_asc,
completed_at_desc,
completed_at_asc,
duration_asc
Example:

"score_desc"

min_score
number | null

Minimum participant score, inclusive

Required range: 0 <= x <= 100
Example:

80

max_score
number | null

Maximum participant score, inclusive

Required range: 0 <= x <= 100
Example:

100

Case-insensitive participant name or email search

Minimum string length: 1
Example:

"Amara"

group_id
string

Filter participants by exact account group ID

Minimum string length: 1
Example:

"group_engineering"

track_id
string

Filter results to participants from a specific track (workflow). When specified, only participants who received the quiz via this track will be included.

Example:

"wf_abc123"

instance_id
string

Filter results to a specific instance. When specified, only participants from this scheduled activity will be included.

Minimum string length: 1
Example:

"abc123"

from_date
string<date-time>

Filter participants by assigned_at >= this exact ISO 8601 instant

Example:

"2026-01-01T00:00:00.000Z"

to_date
string<date-time>

Filter participants by assigned_at <= this exact ISO 8601 instant

Example:

"2026-01-31T23:59:59.999Z"

include_collaborators
enum<string>
default:false

Include quiz admin users in results (default false)

Available options:
true,
false
Example:

"false"

include_participants
enum<string>
default:true

Include participant rows. Set false for summary and analytics only.

Available options:
true,
false
Example:

"false"

include_question_responses
enum<string>
default:false

Include per-question responses for each participant (default false)

Available options:
true,
false
Example:

"true"

include_question_analytics
enum<string>
default:false

Include per-question analytics with answer breakdowns (default false)

Available options:
true,
false
Example:

"true"

include_feedback
enum<string>
default:false

Include feedback responses from post-quiz surveys (default false)

Available options:
true,
false
Example:

"false"

Response

Quiz report with participants and analytics

object
enum<string>
required

Object type identifier

Available options:
quiz_report
Example:

"quiz_report"

id
string
required

Quiz ID

Example:

"quiz_abc123"

title
string
required

Quiz title

Example:

"Product Knowledge Assessment"

summary
object
required

Summary statistics for the report

participants
object[]
required

Paginated list of participants

delivery_instances
object[]
required

Quiz delivery instances (workflows and one-off sends)

has_more
boolean
required

Whether there are more participants available beyond this page

Example:

true

url
string
required

The URL for accessing this report

Example:

"/v1/quizzes/quiz_abc123/report"

next_cursor
string | null
required

Cursor to fetch the next page of participants. Pass as starting_after in subsequent requests.

Example:

"resp_xyz789"

previous_cursor
string | null
required

Cursor to fetch the previous page of participants. Pass as ending_before in subsequent requests.

Example:

"resp_abc123"

question_analytics
object[]

Per-question analytics (only included if include_question_analytics=true)