Skip to main content
GET
List screener responses

Typical workflow

1

List responses

Retrieve screener responses and review participant answers.
2

Qualify or disqualify

Use Qualify Participant to approve or reject based on screener answers.
3

Invite qualified participants

Send invitations via Invite Participant.
4

Mark attendance and pay

After the session, use Mark as Attended to trigger payment.

File upload answers

Answers to fileUpload questions carry a files array and an optional note the participant left with their upload. Each file includes its metadata (name, size, mime, uploadedAt, scanStatus) and a temporary url to download it. The internal storage key is not exposed on responses.
Download URLs expire. Every URL is valid for at least one hour from the moment the response is fetched, but not indefinitely. Do not cache or store the URL.
The recommended pattern is a download button in your UI backed by the most recently fetched URL. When a URL has expired, refetch either this list or the specific screener response. Each fetch issues fresh URLs for every file. A file only carries a url once its virus scan has passed. Until then scanStatus is pending and the url property is absent. Refetch the response later to get the URL. A file whose scanStatus is infected is never downloadable.

Headers

x-api-key
string
required
x-api-secret
string
required

Path Parameters

projectId
string
required

Query Parameters

page
number
default:1

Specifies which page of results to return

pageSize
number
default:50

Number of records to return per page

includeCount
boolean
default:false

If true, includes the total count of records

hidden
boolean
default:false
status
enum<string>
Available options:
PENDING,
EXTERNAL_SCREENER_IN_PROGRESS,
INVITED,
SCHEDULED,
ATTENDED,
NOSHOW,
INVALIDRESPONSE,
REJECTEDQUALITY,
PAID,
CANCELLED
statuses
enum<string>[]
Available options:
PENDING,
EXTERNAL_SCREENER_IN_PROGRESS,
INVITED,
SCHEDULED,
ATTENDED,
NOSHOW,
INVALIDRESPONSE,
REJECTEDQUALITY,
PAID,
CANCELLED
qualified
boolean
favorite
boolean
visibilityStatus
enum<string>
default:VISIBLE
Available options:
DISMISSED,
VISIBLE,
ONHOLD

Response

200 - application/json
page
number
default:1
required
pageSize
number
default:50
required
totalResults
number

The total number of results possible, which is only provided in the response when includeCount is passed as true within a request.

results
object[]
Last modified on September 4, 2026