Download demographic data for a single submission

curl https://api.prolific.com/api/v1/submissions/id/demographics/ \
     -H "Authorization: Token <token>"

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

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

AuthorizationToken

Header authentication of the form Token <token>

Path parameters

idstringRequired

The submission id

Response

Demographic data for the submission

submission_idstring

The ID of the submission

participant_idstring

The ID of the participant who made the submission

custom_study_tncs_accepted_atstring

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

started_atdatetime

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

completed_atdatetime

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

archived_atdatetime

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

time_takeninteger

Time taken to complete the submission in seconds

completion_codestring

The completion code entered by the participant

total_approvalsinteger

Total number of approved submissions by this participant

demographicsmap from strings to any

Demographic data that was archived when the submission was completed

Errors

4XX

Client Request Error

404

Not Found Error