For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Go to app
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
    • Introduction
    • Users
    • Taskflow
    • AI Task Builder
    • Studies
    • Representative sample studies
    • study-collections
    • Filter Sets
    • Participant Groups
    • Custom Groups
    • Study Distribution
    • Submissions
      • Submissions guide
      • Submission object
      • GETList submissions
      • GETRetrieve a submission
      • POSTApprove or reject a submission
      • POSTRequest the participant who submitted the response to return their response
      • POSTBulk approve submissions
    • Bonuses
    • Messages
    • Workspaces
    • Projects
    • Surveys
    • Webhooks
    • Invitations
    • Reward Recommendations
    • Testing
    • Well Known Endpoints
Go to app
LogoLogo
API ReferenceSubmissions

Submission object

|View as Markdown|Open in Claude|

A submission transitions through multiple statuses.

  • RESERVED: Initial state, the participant got a place for your study. By default, we reserve the study place for 10 minutes.
  • ACTIVE: The participant has started your experiment or survey.
  • TIMED-OUT: The submission has timed out, the participant does not have access to the study link. The max time allowed is calculated based on the estimated time for the study, it is always less than 24 hours.
  • AWAITING REVIEW: The participant has completed your experiment or survey.
  • APPROVED: The submission has been approved and paid.
  • RETURNED: The participant returns their submission, acknowledging they will not be paid for it. The study place becomes available for another participant.
  • REJECTED: Submission has been rejected. The participant is not paid. The study place becomes available for another participant.
  • SCREENED OUT: The participant has been screened out. The participant is paid a fixed reward defined in the fixed reward screen out completion code.

Related guide: Submission statuses explained

Was this page helpful?
Previous

Submissions guide

Next

List submissions