View a specific response
Retrieve a single screener response including the participant’s answers, profile data, and current status.
File upload answers
Answers tofileUpload 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.
The recommended pattern is a download button in your UI backed by the most
recently fetched URL. When a URL has expired, refetch this 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.Response
PENDING, EXTERNAL_SCREENER_IN_PROGRESS, INVITED, SCHEDULED, ATTENDED, NOSHOW, INVALIDRESPONSE, REJECTEDQUALITY, PAID, CANCELLED The visibility status of the screener response. If a screener response is visible, it can be interacted with (invited etc). If a screener response is not visible, it cannot be interacted with. A screener may be hidden for various reasons, and a screener can change from visible to not visible at any time if a participant or screener is found to be untrustworthy. There is a webhook that will notify the client when a screener response changes visibility.
- This property is set to
true(withqualifiedset tofalse) if the participant has qualified based on their responses to the screener, but is in the process of verifying their identity. - Once the participant has completed ID verification,
qualifiedPendingIdVerificationwill be set to false.- If the verification was successful,
qualifiedwill be set totrue. - If the verification failed,
qualifiedwill remain set tofalseunless they were manually qualified through the qualification endpoint (PATCH /projects/{projectId}/screener-responses/{screenerResponseId}/qualify).
- If the verification was successful,
researcher, respondent, admin time, final Read-only. Which quota segments this response occupies and in which consumption tier. Present when the project has a quota.