Calculate reward recommendations
Calculate the recommended participant reward rates for a data collection, optionally based upon a given set of filters
Authentication
AuthorizationToken
Header authentication of the form Token <token>
Query parameters
workspace_id
The ID of the workspace in which you'll be creating the study
currency
An ISO 4217 currency code. Note that we only support a selection of currency codes as per the enum values.
Allowed values:
screener_ids
A URL-encoded, comma-delimited list of filter IDs (e.g. custom group filter IDs) that you plan to apply to your study.
There are various methods of converting an array of filter IDs to a URL-encoded, comma delimited array e.g:
JavaScript:
```js
const screenerIDs = ["mandarin", "spanish"];
const encodedScreenerIDs = encodeURIComponent(screenerIDs.join(","));
const url = `https://api.prolific.com/api/v1/reward-recommendations?screener_ids=${encodedScreenerIDs}&workspace_id=<workspace ID>¤cy=GBP`
```
Python:
```python
import urllib.parse
screener_ids = ["mandarin", "spanish"]
encoded_screener_ids = urllib.parse.quote(",".join(screener_ids))
url = f"https://api.prolific.com/api/v1/reward-recommendations?screener_ids={encoded_screener_ids}&workspace_id=<workspace ID>¤cy=GBP"
```
Response
A list of reward recommendations. We suggest using the first recommendation in the list as this is guaranteed to be the most recent set of reward rates.
currency
An ISO 4217 currency code. Note that we only support a selection of currency codes as per the enum values.
Allowed values:
min_reward_per_hour
The **minimum** hourly reward rate that we recommend you pay to your study's participants.
**Note that** this is returned as the hundredth subunit of the given currency i.e:
* for USD, this will be the value in cents
* for GBP, this will be the value in pence
To display this as USD or GBP respectively, you'll need to divide this value by 100 and use an appropriate number formatting API e.g:
JavaScript:
```js
new Intl.NumberFormat("en-US", { style: "currency", currency: "USD" }).format(2000/ 100); // "$20.00"
```
recommended_reward_per_hour
The **good** hourly reward rate that we recommend you pay to your study's participants.
**Note that** this is returned as the hundredth subunit of the given currency i.e:
* for USD, this will be the value in cents
* for GBP, this will be the value in pence
To display this as USD or GBP respectively, you'll need to divide this value by 100 and use an appropriate number formatting API e.g:
JavaScript:
```js
new Intl.NumberFormat("en-US", { style: "currency", currency: "USD" }).format(2000/ 100); // "$20.00"
```
