Skip to main content
We provide 2 screener-responses endpoints to allow invited participants to be paid the projects incentive amount up to 5 times. For instances where the second, third, forth, and fifth payments may need to be higher than the initial incentive, there is a tip field that allows for a payment to a participant to exceed the incentive defined in the project.
Payouts cannot be lower than the incentive defined on the project. It is important to keep the project incentive the lowest dollar amount a participant may get paid.
If researchers are running a multi-stage project and want to advertise the total possible incentive in a research project, this should be included in the project title or description as a callout for “up to $XX incentive”. To maintain trust with participants, the incentive defined in the project is the lowest amount a participant will get paid if they complete the project. If researchers plan to have variable incentives based on quality or time of a study that they will determine after interacting with a participant, the incentive set at the project should be the lowest possible payment.

​
How to use multiple payments

The first payment behavior depends on the project’s automations.autopay setting:
  • autopay: true (the default when omitted at project creation): the first payment fires automatically when the participant is marked as Attended/Complete via Mark as attended. Do not also call the payout endpoint with payoutCount: 1 — that produces a duplicate first payment.
  • autopay: false: Mark as attended records attendance but does not pay the participant. Issue the first payment yourself with POST /v1/projects/{projectId}/screener-responses/{screenerResponseId}/payouts and payoutCount: 1 (or process it from the Respondent dashboard).
For any subsequent payment (payments 2–5), use the endpoints below regardless of the autopay setting.
  • /v1/projects/{projectId}/screener-responses/payouts
  • /v1/projects/{projectId}/screener-responses/{screenerResponseId}/payouts

​
/v1/projects/{projectId}/screener-responses/payouts

  • To begin a followup payment, you must first call the payouts GET with the desired project ID
  • You should receive a response like this:

​
/v1/projects/{projectId}/screener-responses/{screenerResponseId}/payouts

  • After confirming the current number of payments for a profile ID, you can POST the next payment
Notice, this is no option to input incentive. Incentive is fixed during project creation and can only be “increased” by adding a tip.
Last modified on September 14, 2026