Skip to main content

​
Statuses

/v1/projects/{projectId}/screener-responses/{screenerResponseId}/ Updating a participant status in a study happens through screener response endpoints.
CallStatus changeNext actions
QualifyQualifiedInvite, Disqualify, Hide, Report
HideN/A (flag only)N/A
InviteInvitedAttended, Cancel invite, Reject, Report
Cancel InviteReverts to previousInvite, Disqualify, Hide, Report
ScheduleScheduledAttended, Cancel booking, Cancel & reinvite, Reject, No Show, Report
Cancel bookingCancelledRe-invite, Report
Cancel & reinviteInvitedAttended, Cancel invite, Reject, Report
AttendedAttendedNo show, Report
RejectedRejected QualityN/A
No showNo show / Invalid ResponseN/A
FavoriteN/A (flag only)N/A
ReportReportedN/A
Screener responses arrive with a qualified status of true or false based on predetermined criteria. If Respondent passes a participant with qualified = false, your researchers can manually qualify them before inviting.
Hide a participant from the project view. This signals that there is nothing wrong with the participant — they are simply not right for this project.
Pass along booking or task data to the participant. For moderated studies, provide a bookingLink. For unmoderated, provide a meetingLink.
Revert an accidental invitation. The participant loses the ability to schedule a meeting or complete a linked study.
Moderated projects only. After a participant books a time on your platform, send the bookedDate and timezone so their dashboard reflects when they should attend. You can also pass an updated bookingLink with a meeting link.
Moderated projects only. If a researcher cannot make a booked meeting and does not intend to reschedule immediately, this removes the booked time from the participant’s dashboard.
Moderated projects only. Cancel an existing booking and immediately re-invite the participant to book a new time.
Mark a participant as “attended” (moderated) or “complete” (unmoderated). This kicks off incentive payout to the participant.
Indicates the quality of the response did not meet expectations. Stops incentive payment, marks the participant as Rejected Quality, and sends them a notification email.
Moderated: Available after the scheduled meeting time has passed. Marks the participant as excluded from the study. Unmoderated/Survey: Indicates the participant did not complete the task. Stops incentive payment and sends a notification email.
Flag a participant as a favorite. Useful for identifying high-quality participants you may want to work with again.
Report a suspicious or fraudulent participant. Reported participants cannot apply to future studies from your organization, and the Respondent team investigates whether they should be removed from the platform.

​
Example status flows

  • Invite → Schedule → Attended / No show / Reject
  • Qualify → Invite → Schedule → Attended / No show / Reject
  • Invite → Schedule → Cancel booking & reinvite → Schedule → Attended / No show / Reject