# Reviewing submissions and rewards

# Reviewing submissions and rewards

This guide covers how to set up rewards and approve submissions via the API.

When creating the study, set the reward for completing the task. Read [our guide here](https://researcher-help.prolific.com/en/article/8d9da9) on how to decide on a reward amount.

For a participant to be paid, their submission needs to be approved. There are 3 ways to approve a submission:

## Option 1: Automatic approval

<Steps>
  <Step title="Create the study">
    <RunnableEndpoint endpoint="POST /api/v1/studies/" example="study_with_automatic_approval" readonly={["examples"]} />
  </Step>

  <Step title="On your survey tool">
    When the participant completes the task, redirect them to Prolific with the completion code:

    ```
    https://app.prolific.com/submissions/complete?cc={completion code}
    ```

    See our [integration
    guide](https://researcher-help.prolific.com/en/articles/445179-survey-software-integration-guides) for various
    survey tools.
  </Step>

  <Step title="Publish the study">
    <RunnableEndpoint endpoint="POST /api/v1/studies/{id}/transition/" example="publish_study" readonly={["examples"]} />

    Participants will then be automatically paid once they complete the submission.
  </Step>
</Steps>

## Option 2: Manual review

<Steps>
  <Step title="Create the study">
    <RunnableEndpoint endpoint="POST /api/v1/studies/" example="minimal_study" readonly={["examples"]} />
  </Step>

  <Step title="Publish the study">
    <RunnableEndpoint endpoint="POST /api/v1/studies/{id}/transition/" example="publish_study" readonly={["examples"]} />
  </Step>

  <Step title="On your survey tool">
    When the participant completes the task, redirect them to Prolific with the completion code:

    ```
    https://app.prolific.com/submissions/complete?cc={completion code}
    ```

    See our [integration
    guide](https://researcher-help.prolific.com/en/articles/445179-survey-software-integration-guides) for various
    survey tools.
  </Step>

  <Step title="Approve the submission">
    When a participant is sent to the survey tool, their submission ID will be in the URL parameters from Step 1. Use
    this submission ID to approve the submission.

    <RunnableEndpoint endpoint="POST /api/v1/submissions/{id}/transition/" example="Approving a submission" readonly={["examples"]} />
  </Step>
</Steps>

## Option 3: Bulk approval

If you prefer to manually review submissions, and are likely to review a large number of submissions at once, use the bulk approval endpoint to prevent being rate limited.

<Steps>
  <Step title="Create the study">
    <RunnableEndpoint endpoint="POST /api/v1/studies/" example="minimal_study" readonly={["examples"]} />
  </Step>

  <Step title="Publish the study">
    <RunnableEndpoint endpoint="POST /api/v1/studies/{id}/transition/" readonly={["examples"]} example="publish_study" />
  </Step>

  <Step title="On your survey tool">
    When the participant completes the task, redirect them to Prolific with the completion code:

    ```
    https://app.prolific.com/submissions/complete?cc={completion code}
    ```

    See our [integration
    guide](https://researcher-help.prolific.com/en/articles/445179-survey-software-integration-guides) for various
    survey tools.
  </Step>

  <Step title="Approve the submissions in bulk">
    When participants are sent to the survey tool, their submission IDs will be in the URL parameters from Step 1. Use
    these submission IDs to approve the submissions in bulk.

    <RunnableEndpoint endpoint="POST /api/v1/submissions/bulk-approve/" example="bulk_approve_two_participants" readonly={["examples"]} />
  </Step>
</Steps>

<Note title="Note">
  * Before you publish a study, make sure you have enough funds in your account to approve the required number of submissions. Check out our [Workspace
    balance & adding money](https://researcher-help.prolific.com/en/articles/445246-workspace-balance) guide to learn
    more.
  * Any submissions Awaiting Review 21 days after completion will be auto-approved.
</Note>