---
title: "Set up bonuses"
method: POST
path: "/api/v1/submissions/bonus-payments/"
tags: ["bonuses"]
---

# Set up bonuses

`POST /api/v1/submissions/bonus-payments/`

Set up bonus payments to one or more participants/submissions in a study.

You need the study id, the participant|submission ids and the request in CSV format.

The csv_bonuses field needs to be structured in the format of either:

- `<participant_id>,<amount>\n`.
- `<submission_id>,<amount>\n`.

**Note: The amount will be in the study currency. The amount should be a decimal value, e.g. 1.50 for £1.50.**
Warning: An amount of 30 will pay £/$30.00.

As an example, `60ffe5c8371090c7041d43f8,4.25` would be a bonus of £4.25 for participant 60ffe5c8371090c7041d43f8 in a study with GBP currency.

Setting up a bonus payment does not actually pay them, to do so check [/api/v1/bulk-bonus-payments/{id}/pay/](#tag/Bonuses/paths/~1api~1v1~1bulk-bonus-payments~1%7Bid%7D~1pay~1/post)

The submission and participant IDs need to have taken part in the study in order for this call to be successful.
If not, you will get a "400" HTTP response back, which explains which IDs are incorrect.

We recommend a maximum of 200 participant or submission IDs per request.

## Headers

- `Authorization` string, required

## Request body

- object
  - `study_id` string
  - `csv_bonuses` string

## Response `201`

Bonus created

- BulkBonus
  - `id` string, required — Bonus ID. It is the ID to be used when paying the bonus
  - `study` string — Study ID
  - `amount` number, double — The amount the participant will receive in cents
  - `fees` number, double — The fees Prolific will charge for this bonus in cents
  - `vat` number, double — The VAT cost for this bonus in cents
  - `total_amount` number, double, required — Total amount that will be deducted from your balance in cents

## Other responses

- `400` — Error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/dc6f073a9827/schema)