---
title: "Get Batch Responses"
method: GET
path: "/api/v1/data-collection/batches/{batch_id}/responses"
tags: ["aiTaskBuilder"]
---

# Get Batch Responses

`GET /api/v1/data-collection/batches/{batch_id}/responses`

Get responses for an AI Task Builder batch as JSON. Returns individual response records for programmatic processing.

## Path parameters

- `batch_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- AITaskBuilderGetTaskBuilderBatchTaskResponsesResponse200
  - `results` AITaskBuilderTaskResponse[]
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `batch_id` string, required
    - `participant_id` string, required
    - `submission_id` string — The Prolific submission ID
    - `correlation_id` string — Correlation ID for tracking
    - `response` AiTaskBuilderTaskResponseResponse, required
      - `instruction_id` string, required
      - `type` 'multiple_choice' | 'free_text' | 'free_text_with_unit' | 'multiple_choice_with_free_text' | 'file_upload', required
      - `answer` AiTaskBuilderTaskResponseResponseAnswerItems[], required
        - `value` union
          - string
          - number, double
          - boolean
    - `task_id` string, required
    - `metadata` object
    - `schema_version` integer
    - `no_submission` boolean
  - `meta` ApiV1DataCollectionBatchesBatchIdResponsesGetResponsesContentApplicationJsonSchemaMeta
    - `count` integer — Total number of responses

## 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/versions/5c53371c41a0/schema)