List all filters | Prolific API

curl -G https://api.prolific.com/api/v1/filters/ \
     -H "Authorization: Token <token>" \
     -d filter_tag=custom-group

{
  "results": [
    {
      "filter_id": "handedness",
      "title": "Handedness",
      "description": "Whether a person is left or right-handed.",
      "question": "Are you left or right-handed?",
      "type": "select",
      "data_type": "ChoiceID",
      "choices": {
        "0": "Right-handed",
        "1": "Left-handed",
        "2": "Ambidextrous"
      }
    },
    {
      "filter_id": "previous_studies",
      "title": "Previous Studies AllowList",
      "description": "Select one or more studies to allow participants who have completed them to participate in this study.",
      "type": "select",
      "data_type": "StudyID",
      "choices": {
        "645e4403bdd06d5f66d8fbd5": "Study 1 internal name",
        "645e4403bdd06d5f66d8fbd8": "Study 2 internal name",
        "645e4403bdd06d5f66d8fbdb": "Study 3 internal name"
      }
    },
    {
      "filter_id": "custom_allowlist",
      "title": "Custom AllowList",
      "description": "Select one or more participant ID's to allow participants to complete this study.",
      "type": "select",
      "data_type": "ParticipantID",
      "choices": {
        "0": "Add a list of participant ID's to create an allowlist filter."
      }
    },
    {
      "filter_id": "age",
      "title": "Age",
      "question": "How old are you?",
      "description": "",
      "type": "range",
      "data_type": "integer",
      "min": 18,
      "max": 100
    },
    {
      "filter_id": "joined_between",
      "title": "Joined Between",
      "description": "Allow participants who joined between the specified dates to participate in this study.",
      "type": "range",
      "data_type": "date",
      "min": "2020-01-01",
      "max": "2021-01-01"
    }
  ]
}

List all filters that can be applied to your filter sets or studies.

curl -G https://api.prolific.com/api/v1/filters/ \
     -H "Authorization: Token <token>" \
     -d filter_tag=custom-group

{
  "results": [
    {
      "filter_id": "handedness",
      "title": "Handedness",
      "description": "Whether a person is left or right-handed.",
      "question": "Are you left or right-handed?",
      "type": "select",
      "data_type": "ChoiceID",
      "choices": {
        "0": "Right-handed",
        "1": "Left-handed",
        "2": "Ambidextrous"
      }
    },
    {
      "filter_id": "previous_studies",
      "title": "Previous Studies AllowList",
      "description": "Select one or more studies to allow participants who have completed them to participate in this study.",
      "type": "select",
      "data_type": "StudyID",
      "choices": {
        "645e4403bdd06d5f66d8fbd5": "Study 1 internal name",
        "645e4403bdd06d5f66d8fbd8": "Study 2 internal name",
        "645e4403bdd06d5f66d8fbdb": "Study 3 internal name"
      }
    },
    {
      "filter_id": "custom_allowlist",
      "title": "Custom AllowList",
      "description": "Select one or more participant ID's to allow participants to complete this study.",
      "type": "select",
      "data_type": "ParticipantID",
      "choices": {
        "0": "Add a list of participant ID's to create an allowlist filter."
      }
    },
    {
      "filter_id": "age",
      "title": "Age",
      "question": "How old are you?",
      "description": "",
      "type": "range",
      "data_type": "integer",
      "min": 18,
      "max": 100
    },
    {
      "filter_id": "joined_between",
      "title": "Joined Between",
      "description": "Allow participants who joined between the specified dates to participate in this study.",
      "type": "range",
      "data_type": "date",
      "min": "2020-01-01",
      "max": "2021-01-01"
    }
  ]
}

List all filters that can be applied to your filter sets or studies.

Authentication

AuthorizationToken

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

Query parameters

detailedstringOptional

Include extra information required to sort and categorise filters in the Prolific app. This is not required for API use. Default false.

workspace_idstringOptional

The workspace ID for the workspace you are creating a study or filterset in. This is used to get contextual data such as previous studies and participant groups.

filter_tagstringOptional

Can be used to return only Custom Group filters.

Response

List of filters

resultslist of objects

_linksmap from strings to any

metamap from strings to any

Errors

4XX

Client Request Error

$	curl -G https://api.prolific.com/api/v1/filters/ \
>	-H "Authorization: Token <token>" \
>	-d filter_tag=custom-group

1	{
2	"results": [
3	{
4	"filter_id": "handedness",
5	"title": "Handedness",
6	"description": "Whether a person is left or right-handed.",
7	"question": "Are you left or right-handed?",
8	"type": "select",
9	"data_type": "ChoiceID",
10	"choices": {
11	"0": "Right-handed",
12	"1": "Left-handed",
13	"2": "Ambidextrous"
14	}
15	},
16	{
17	"filter_id": "previous_studies",
18	"title": "Previous Studies AllowList",
19	"description": "Select one or more studies to allow participants who have completed them to participate in this study.",
20	"type": "select",
21	"data_type": "StudyID",
22	"choices": {
23	"645e4403bdd06d5f66d8fbd5": "Study 1 internal name",
24	"645e4403bdd06d5f66d8fbd8": "Study 2 internal name",
25	"645e4403bdd06d5f66d8fbdb": "Study 3 internal name"
26	}
27	},
28	{
29	"filter_id": "custom_allowlist",
30	"title": "Custom AllowList",
31	"description": "Select one or more participant ID's to allow participants to complete this study.",
32	"type": "select",
33	"data_type": "ParticipantID",
34	"choices": {
35	"0": "Add a list of participant ID's to create an allowlist filter."
36	}
37	},
38	{
39	"filter_id": "age",
40	"title": "Age",
41	"question": "How old are you?",
42	"description": "",
43	"type": "range",
44	"data_type": "integer",
45	"min": 18,
46	"max": 100
47	},
48	{
49	"filter_id": "joined_between",
50	"title": "Joined Between",
51	"description": "Allow participants who joined between the specified dates to participate in this study.",
52	"type": "range",
53	"data_type": "date",
54	"min": "2020-01-01",
55	"max": "2021-01-01"
56	}
57	]
58	}