---
title: "List a query's responses (API-key-only)"
method: GET
path: "/queries/{id}/responses"
tags: ["Queries"]
---

# List a query's responses (API-key-only)

`GET /queries/{id}/responses`

## Request

- Base URL: `https://www.getabrain.ai/api/v1`
- URL: `https://www.getabrain.ai/api/v1/queries/{id}/responses`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Responses

- object
  - `query_id` string, uuid
  - `responses` object[]
    - `id` string, uuid
    - `response_data` union
      - TextResponse
        - `answer` string, required
        - `reasoning` string
      - MultipleChoiceResponse
        - `selected_ids` string[], required
        - `reasoning` string
      - RatingScaleResponse
        - `rating` number, required
        - `criteria_ratings` object
        - `feedback` string
      - ImageComparisonResponse
        - `selected_image_id` string, required
        - `ranking` string[]
        - `reasoning` string, required
      - RankingResponse
        - `ranked_ids` string[], required
        - `reasoning` string
      - YesNoResponse
        - `answer` 'yes' | 'no', required
        - `explanation` string
      - SentimentResponse
        - `sentiment` 'very_positive' | 'positive' | 'neutral' | 'negative' | 'very_negative', required
        - `reasoning` string
        - `confidence_level` number
      - ImageSelectionResponse
        - `selected_image_ids` string[], required
        - `reasoning` string
      - FreeFormTextResponse
        - `text` string, required
        - `word_count` integer, required
      - VideoReviewResponse
        - `watched_seconds` integer, required
        - `review` object, required
        - `overall_feedback` string, required
        - `rating` number
      - AudioReviewResponse
        - `listened_seconds` integer, required
        - `review` object, required
        - `overall_feedback` string, required
        - `transcription` string
      - ImageAnalysisResponse
        - `analysis` string
        - `observations` string
      - AbTestResponse
        - `choice` 'A' | 'B', required
        - `reasoning` string
      - VoiceCaptureResponse
        - `audio_url` string, required: Hosted audio URL from POST /workers/uploads
        - `duration_seconds` integer
        - `transcription` string
      - VideoCaptureResponse
        - `video_url` string, required: Hosted video URL from POST /workers/uploads
        - `duration_seconds` integer
      - PhotoCaptureResponse
        - `image_url` string, required: Hosted image URL from POST /workers/uploads
        - `caption` string
    - `status` string
    - `submitted_at` string, date-time
    - `worker` object
      - `quality_score` number
      - `tier` string
      - `rating_count` integer
    - `rating` object, nullable
      - `score` integer
      - `feedback_text` string, nullable
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `has_more` boolean

## Other responses

- `401`: Missing or invalid authentication
- `404`: Resource not found
- `429`: Too many requests for your account tier (see GET /requestor/usage for your limits). Wait Retry-After seconds and retry.

---

[API](https://skmtc.dev/getabrain/apis/getabrain-ai-api.md) · [All operations](https://skmtc.dev/getabrain/apis/getabrain-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getabrain/apis/getabrain-ai-api/revisions/e9da90b7b72c?raw)