--- title: "List Collections" method: GET path: "/api/v1/data-collection/collections" tags: ["aiTaskBuilder"] --- # List Collections `GET /api/v1/data-collection/collections` Get all AI Task Builder Collections for a workspace. ## Query parameters - `workspace_id` string, required ## Headers - `Authorization` string, required ## Response `200` OK - AITaskBuilderListCollectionsResponse200 - `results` Collection[] - `id` string, uuid, required - `schema_version` '1', required - `created_at` string, date-time, required — ISO-8601 formatted creation timestamp in UTC - `created_by` string, required — User ID of the Prolific user that created the collection - `workspace_id` string, required — The ID of the Prolific workspace - `name` string, required — The name of the collection - `task_details` TaskDetails, required — Task metadata displayed to participants - `task_name` string, required — The title displayed to participants - `task_introduction` string, required — HTML formatted introduction shown at the start of the task - `task_steps` string, required — HTML formatted step-by-step instructions - `collection_items` CollectionItem[], required — Pages within the collection. Each collection item represents a page. - `id` string, uuid, required - `created_at` string, date-time, required - `created_by` string, required - `schema_version` '1', required - `page_items` PageItem[], required — Instructions and content blocks on this page - union — An instruction or content block within a page - object — multiple_choice variant - `type` 'multiple_choice', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent batch or collection - `parent_type` 'batch' | 'collection', required - `created_by` string, required - `description` string, required - `order` integer, required - `helper_text` string — Additional guidance text displayed below the question - `placeholder_text_input` string — Placeholder text displayed in the input field - `answer_limit` integer, required - `disable_dropdown` boolean - `options` CollectionMultipleChoiceInstructionOptionsItems[], required - … - object — free_text variant - `type` 'free_text', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent batch or collection - `parent_type` 'batch' | 'collection', required - `created_by` string, required - `description` string, required - `order` integer, required - `helper_text` string — Additional guidance text displayed below the question - `placeholder_text_input` string — Placeholder text displayed in the input field - `validation` ValidationRule — Optional validation constraints for input values - … - object — free_text_with_unit variant - `type` 'free_text_with_unit', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent batch or collection - `parent_type` 'batch' | 'collection', required - `created_by` string, required - `description` string, required - `order` integer, required - `helper_text` string — Additional guidance text displayed below the question - `placeholder_text_input` string — Placeholder text displayed in the input field - `unit_options` CollectionFreeTextWithUnitInstructionUnitOptionsItems[], required — List of available units that participants can select from - … - `default_unit` string — Default selected unit (must match a value from unit_options) - `unit_position` 'prefix' | 'suffix', required — Position of the unit selector relative to the text input. Use 'prefix' for units before the input (e.g., currency symbols) or 'suffix' for units after the input (e.g., measurements). - object — multiple_choice_with_free_text variant - `type` 'multiple_choice_with_free_text', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent batch or collection - `parent_type` 'batch' | 'collection', required - `created_by` string, required - `description` string, required - `order` integer, required - `helper_text` string — Additional guidance text displayed below the question - `placeholder_text_input` string — Placeholder text displayed in the input field - `answer_limit` integer, required - `disable_dropdown` boolean - `options` CollectionMultipleChoiceWithFreeTextInstructionOptionsItems[], required - … - object — file_upload variant - `type` 'file_upload', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent batch or collection - `parent_type` 'batch' | 'collection', required - `created_by` string, required - `description` string, required - `order` integer, required - `helper_text` string — Additional guidance text displayed below the question - `placeholder_text_input` string — Placeholder text displayed in the input field - `accepted_file_types` string[] — File extensions to accept (e.g., [".jpg", ".png", ".pdf"]). Each extension must start with a dot. Defaults to [".jpg", ".jpeg", ".png", ".heic", ".heif"] if not specified. - `max_file_size_mb` number, double — Maximum file size in megabytes per file. Must be a positive number. Defaults to 25. - `min_file_count` integer — Minimum number of files required. Must be at least 1. Defaults to 1. - `max_file_count` integer — Maximum number of files allowed. Must be at least 1 and greater than or equal to min_file_count. Defaults to 10. - object — image variant - `type` 'image', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent collection item (page) - `parent_type` 'collection' | 'batch', required - `created_by` string, required - `schema_version` '1', required - `url` string, uri, required — HTTPS URL of the image - `alt_text` string, required — Alt text for accessibility - `caption` string — Optional caption displayed below the image - object — rich_text variant - `type` 'rich_text', required - `id` string, uuid, required - `created_at` string, date-time, required - `parent_id` string, uuid, required — ID of the parent collection item (page) - `parent_type` 'collection' | 'batch', required - `created_by` string, required - `schema_version` '1', required - `content` string, required — HTML content. If the original input used Markdown, it has been converted to HTML. - `last_modified_at` string, date-time — ISO-8601 formatted last modification timestamp in UTC - `last_modified_by` string — User ID of the Prolific user that last modified the collection - `meta` ApiV1DataCollectionCollectionsGetResponsesContentApplicationJsonSchemaMeta - `count` integer — Total number of collections ## Other responses - `400` — Error --- [API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/revisions/dc6f073a9827/schema)