Download demographic data for a single submission

Overview

Retrieves demographic data for a specific submission, reflecting a snapshot of the participant’s demographics at the time of submission completion.

Data Source

Demographic data is retrieved from archives and is not generated on-the-fly
If no archived demographic data exists for the submission, a 404 response will be returned

Data Format

The demographic dataset is dynamic and evolves as questions are added or removed
For questions that weren’t answered by the participant, the value will be DATA_EXPIRED
Fields may include standard demographic information such as age range, gender, education level, etc.

This feature is only available to specific workspaces.

### Overview Retrieves demographic data for a specific submission, reflecting a snapshot of the participant's demographics at the time of submission completion. ### Data Source - Demographic data is retrieved from archives and is not generated on-the-fly - If no archived demographic data exists for the submission, a 404 response will be returned ### Data Format - The demographic dataset is dynamic and evolves as questions are added or removed - For questions that weren't answered by the participant, the value will be `DATA_EXPIRED` - Fields may include standard demographic information such as age range, gender, education level, etc. This feature is only available to specific workspaces.

Authentication

Authorizationstring

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>.

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>`.

Path Parameters

idstringRequired

The submission id

Response

Demographic data for the submission

submission_idstring or null

The ID of the submission

participant_idstring or null

The ID of the participant who made the submission

custom_study_tncs_accepted_atstring or null

When custom study terms and conditions were accepted, if not accepted this will be Not Applicable

started_atdatetime or null

When the submission was started (UTC, ISO 8601 format)

completed_atdatetime or null

When the submission was completed (UTC, ISO 8601 format)

archived_atdatetime or null

When the demographic data was archived (UTC, ISO 8601 format)

time_takeninteger or null

Time taken to complete the submission in seconds

completion_codestring or null

The completion code entered by the participant

total_approvalsinteger or null

Total number of approved submissions by this participant

demographicsmap from strings to any or null

Demographic data that was archived when the submission was completed

1	import requests
2
3	url = "https://api.prolific.com/api/v1/submissions/id/demographics/"
4
5	headers = {"Authorization": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"submission_id": "66e935217693b408876194dd",
3	"participant_id": "669122b3bd514d002aea9fe5",
4	"custom_study_tncs_accepted_at": "2025-09-24T12:26:51.226000Z",
5	"started_at": "2025-09-24T12:26:56.834000Z",
6	"completed_at": "2025-10-13T10:18:33.131366Z",
7	"archived_at": "2024-09-17T07:52:11.368105Z",
8	"time_taken": 118,
9	"completion_code": "C11FUIH9",
10	"total_approvals": 10,
11	"demographics": {
12	"Age": 27,
13	"Sex": "Male",
14	"Ethnicity simplified": "White",
15	"Country of birth": "United Kingdom",
16	"Country of residence": "United Kingdom",
17	"Nationality": "United Kingdom",
18	"Language": "English",
19	"Student status": "No",
20	"Employment status": "Not in paid work (e.g. homemaker, retired or disabled)"
21	}
22	}

Overview

Data Source

Data Format

Authentication

Path Parameters

Response

Errors

Overview

Data Source

Data Format