v4
OpenAPI 3.1.02026-07-31121440441.0 KBExport demographic data
Create and download a demographic export for a study. This endpoint allows you to export participant demographic data with optional study filter data.
Filter Support: This endpoint supports applying demographic filters to export data for participants who match specific criteria.
When filters are provided, the export includes both base demographic data (age, sex, country, etc.) and the filters.
When no filters are provided, the export includes only base demographic data for all participants who took the study, excluding any study-specific filter responses.
Export Usage: Please note that you may only select up to 15 filters per export. You are also limited to 2 different filter export requests.
You may download the same request as many times as you need. To check your current usage and see your latest export history, use the Demographic Export History endpoint.
Basic Data Included: The export includes the following data fields:
- Submission ID
- Participant ID
- Submission status
- Started date-time
- Expressed in UTC
- ISO 8601 formatted
- Completed date-time
- Expressed in UTC
- ISO 8601 formatted
- Time taken (in seconds)
- Age
- Sex
- Participants were asked the following question: What is your sex, as recorded on legal/official documents?
- Ethnicity (simplified)
- First language
- Current country of residence
- Nationality
- Country of birth
- Student status
- Employment status
- Reviewed at date-time
- Expressed in UTC
- ISO 8601 formatted
- Completion code ('entered code')
- Total approvals
Learn more on Exporting Prolific demographic data.
Path parameters
Study ID
Headers
The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add Authorization header with the value Token <your token>.
Request body
Response
Demographic data exported successfully