Documentation for the Prefill-API of our order form
Our orderform can be accessed in 3 languages: English, German & French
English: https://app.testingtime.com/en/order-testusers/{amount-of-users}/{method}
German: https://app.testingtime.com/de/testpersonen-bestellen/{amount-of-users}/{method}
French: https://app.testingtime.com/fr/commande-participants-aux-tests/{amount-of-users}/{method}
Parameter | Description | Type | Constraints | Other |
---|---|---|---|---|
amount-of-users | How many users will be recruited | number | 3-300 | |
method | The method of the study that will be conducted | string | usertest workshop interview focusgroup survey diary |
Many fields on the order form can be prefilled. Here are all the supported parameters. They are all optional.
Parameter | Description | Type | Constraints | Other |
---|---|---|---|---|
min-age | Minimal age of the ordered participants. | number | 18-85 | Only works if you provide a max-age as well |
max-age | Maximal age of the ordered participants. | number | 18-85 | Only works if you provide a min-age as well. Must be at least 10 years more than the min-age. |
gender | Gender mix if relevant. | string | female male mixed |
|
languages | Languages a test user needs to speak at least fluently | string | de fr en it nl |
Comma separated if multiple. Max 2. |
countries | Countries where the test users have to currently live at. | string | 2 digit ISO-Code - lowercase | Comma separated if multiple. Max 10. |
slots | List of all dates when the study will be conducted | string | timestamp | Comma separated numbers |
customs | Special criteria for the participants. | string | Max 140 characters each | Comma separated, max 5. |
minutes | Duration of each study | number | 10-5000 | |
title | Study title | string | Max 255 characters | |
description | Additional information for the TestingTime recruiters | string | ||
venue | Where does the study happen | string | IN_HOME IN_HOUSE REMOTE |
|
devices | On what devices do the participants need to be "native" at | string | computer tablet phone watch |
Comma separated strings |
platform | What OS needs to be installed on the devices | string | apple android windows |
Only works if "devices" is provided |
contact-firstname | Customer contacts (study conductor) first name | string | ||
contact-lastname | Customer contacts (study conductor) last name | string | ||
contact-email | Customer contacts (study conductor) email | string | ||
contact-phone | Customer contacts (study conductor) phone | string | ||
billing-company | Customer billing address - company name | string | ||
billing-address | Customer billing address - address line 1 | string | ||
billing-address2 | Customer billing address - address line 2 | string | ||
billing-zip | Customer billing address - zip code | string | ||
billing-city | Customer billing address - city name | string | ||
billing-country | Customer billing address - country | string | 2 digit ISO-Code - lowercase | |
billing-instructions | Customer billing reference number | string | ||
billing-email | Customer billing email address | string | ||
location-company | Location of study - company name | string | ||
location-address | Location of study - address line | string | ||
location-zip | Location of study - zip code | string | ||
location-city | Location of study - city name | string | ||
location-company | Location of study - company name | string | ||
location-country | Location of study - country | string | 2 digit ISO-Code - lowercase | |
location-instructions | Location of study - description how to find the location | string | e.g. "ask at the reception for John Meyer" | |
duration | How long does it take to fill out the entire survey or unmoderated user test. | number | 10-500 | Only works its a survey or an unmoderated user test. |
link | The link to the survey or unmoderated user test. | string | Only works its a survey or an unmoderated user test. If link & priority are provided for a method type "user test" it becomes automatically an unmoderated user test. | |
priority | How fast do we need to deliver the participants | string | normal express emergency |
Only works its a survey or an unmoderated user test. |
"contactVia", "contactViaDetails", "expert-exclusion",
"deadline",
"priority", "link", "survey-by-redirect", "final-survey", "frequency",
"inHomeModeOfTransport",
"inviteRadius"
If you prefill all necessary information, you can choose the step of the order form that is shown at first.
Value | Step | Description |
---|---|---|
#!/profile | 1 | Default - Select the users basic profile |
#!/setup | 2 | Setup for your study Not available on method "survey" |
#!/survey | 2 | Link and priority settings for survey Only available on method "survey" |
#!/dates | 3 | Timing of your study Not available on methods "survey" & "diary" |
#!/review | 3-4 | Review all your changes => suggested if all necessary data is prefilled |
#!/payment | 4-5 | If you are sure all is already setup and you want to send the user to the payment step directly |