> ## Documentation Index
> Fetch the complete documentation index at: https://developers.respondent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Response statuses

> Understand participant statuses and the actions available at each stage

## Statuses

**/v1/projects/\{projectId}/screener-responses/\{screenerResponseId}/**

Updating a participant status in a study happens through screener response endpoints.

| Call                                                                | Status change              | Next actions                                                         |
| ------------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------- |
| [Qualify](/screener-responses/qualify-participant)                  | Qualified                  | Invite, Disqualify, Hide, Report                                     |
| [Hide](/screener-responses/hide-participant)                        | N/A (flag only)            | N/A                                                                  |
| [Invite](/screener-responses/invite-participant)                    | Invited                    | Attended, Cancel invite, Reject, Report                              |
| [Cancel Invite](/screener-responses/cancel-invite)                  | Reverts to previous        | Invite, Disqualify, Hide, Report                                     |
| [Schedule](/screener-responses/schedule-participant)                | Scheduled                  | Attended, Cancel booking, Cancel & reinvite, Reject, No Show, Report |
| [Cancel booking](/screener-responses/cancel-booking)                | Cancelled                  | Re-invite, Report                                                    |
| [Cancel & reinvite](/screener-responses/cancel-booking-&-re-invite) | Invited                    | Attended, Cancel invite, Reject, Report                              |
| [Attended](/screener-responses/mark-as-attended)                    | Attended                   | No show, Report                                                      |
| [Rejected](/screener-responses/mark-as-rejected)                    | Rejected Quality           | N/A                                                                  |
| [No show](/screener-responses/mark-as-no-show)                      | No show / Invalid Response | N/A                                                                  |
| [Favorite](/screener-responses/mark-as-favorite)                    | N/A (flag only)            | N/A                                                                  |
| [Report](/screener-responses/report-participant)                    | Reported                   | N/A                                                                  |

<AccordionGroup>
  <Accordion title="Qualify">
    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.
  </Accordion>

  <Accordion title="Hide">
    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.
  </Accordion>

  <Accordion title="Invite">
    Pass along booking or task data to the participant. For moderated studies, provide a `bookingLink`. For unmoderated, provide a `meetingLink`.
  </Accordion>

  <Accordion title="Cancel Invite">
    Revert an accidental invitation. The participant loses the ability to schedule a meeting or complete a linked study.
  </Accordion>

  <Accordion title="Schedule">
    **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.
  </Accordion>

  <Accordion title="Cancel booking">
    **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.
  </Accordion>

  <Accordion title="Cancel booking & reinvite">
    **Moderated projects only.** Cancel an existing booking and immediately re-invite the participant to book a new time.
  </Accordion>

  <Accordion title="Attended">
    Mark a participant as "attended" (moderated) or "complete" (unmoderated). **This kicks off incentive payout to the participant.**
  </Accordion>

  <Accordion title="Rejected">
    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.
  </Accordion>

  <Accordion title="No show">
    **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.
  </Accordion>

  <Accordion title="Favorite">
    Flag a participant as a favorite. Useful for identifying high-quality participants you may want to work with again.
  </Accordion>

  <Accordion title="Report">
    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.
  </Accordion>
</AccordionGroup>

## Skipped questions

Organizations that opt in to including skipped questions in screener responses receive an entry in `responses[]` for every screener question, with `skipped`, `skippedBy`, and `shown` flags marking questions the participant did not answer. See [Collecting responses](/screener-responses/collecting-responses#skipped-questions-in-responses) for the field reference and examples.

## Example status flows

<Tabs>
  <Tab title="Moderated">
    * Invite → Schedule → Attended / No show / Reject
    * Qualify → Invite → Schedule → Attended / No show / Reject
    * Invite → Schedule → Cancel booking & reinvite → Schedule → Attended / No show / Reject
  </Tab>

  <Tab title="Unmoderated">
    * Invite → Attended / No show / Reject
    * Invite → Cancel invite
    * Qualify → Invite → Attended / No show → Favorite
  </Tab>
</Tabs>