---
title: "Get a query with its responses"
method: GET
path: "/requestor/queries/{id}"
tags: ["Queries"]
---

# Get a query with its responses

`GET /requestor/queries/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

Query with responses

- object
  - `id` string, uuid
  - `type` string
  - `title` string
  - `description` string
  - `required_responses` integer
  - `completed_responses` integer
  - `bid_amount_cents` integer
  - `bonus_amount_cents` integer
  - `total_cost_cents` integer
  - `status` 'pending' | 'active' | 'moderation_hold' | 'completed' | 'cancelled' | 'failed' | 'expired' | 'rejected'
  - `created_at` string, date-time
  - `expires_at` string, date-time, nullable
  - `content_data` union
    - TextContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `min_words` integer
      - `max_words` integer
      - `required_fields` string[]
    - MultipleChoiceContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `options` object[], required
        - `id` string, required
        - `text` string, required
        - `image_url` string
      - `allow_multiple` boolean
      - `min_selections` integer
      - `max_selections` integer
    - RatingScaleContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `scale_type` '1-5' | '1-10' | '0-100' | 'stars', required
      - `scale_min` number, required
      - `scale_max` number, required
      - `scale_labels` object
        - `min_label` string
        - `mid_label` string
        - `max_label` string
      - `criteria` string[]
      - `media_url` string: Optional HTTP(S) reference URL, rendered as a plain link
      - `media_image_url` string: Optional image to display above the rating question
      - `media_video_url` string: Optional YouTube URL to embed above the rating question
      - `media_audio_url` string: Optional audio URL to embed above the rating question
    - ImageComparisonContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `images` object[], required
        - `id` string, required
        - `url` string, required
        - `label` string
        - `description` string
      - `comparison_type` 'preference' | 'quality' | 'relevance' | 'custom', required
      - `require_reasoning` boolean
    - RankingContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `items` object[], required
        - `id` string, required
        - `text` string, required
        - `image_url` string
        - `description` string
      - `max_items` integer, required
      - `require_all` boolean
    - YesNoContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `require_explanation` boolean
      - `min_explanation_words` integer
    - SentimentContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `subject` string, required
      - `sentiment_options` string[], required
      - `require_reasoning` boolean
    - ImageSelectionContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `images` object[], required
        - `id` string, required
        - `url` string, required
        - `caption` string
      - `min_selections` integer, required
      - `max_selections` integer, required
      - `selection_criteria` string, required
    - FreeFormTextContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `prompt` string, required
      - `min_characters` integer
      - `max_characters` integer
      - `format_guidelines` string
    - VideoReviewContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `video_url` string, required: YouTube URL
      - `video_duration_seconds` integer, required
      - `review_aspects` string[], required
      - `min_watch_time_seconds` integer
    - AudioReviewContent
      - `question` string, required
      - `instructions` string
      - `context` string
      - `audio_url` string, required
      - `audio_duration_seconds` integer, required
      - `review_aspects` string[], required
      - `transcription_required` boolean
    - ImageAnalysisContent
      - `question` string, required
      - `image_url` string, required: HTTP(S) image URL
    - AbTestContent
      - `question` string, required
      - `variant_a` object, required
        - `description` string, required
        - `image_url` string
        - `url` string
      - `variant_b` object, required
        - `description` string, required
        - `image_url` string
        - `url` string
    - VoiceCaptureContent
      - `question` string
      - `instructions` string
      - `context` string
      - `prompt` string, required
      - `max_duration_seconds` integer
    - VideoCaptureContent
      - `question` string
      - `instructions` string
      - `context` string
      - `prompt` string, required
      - `max_duration_seconds` integer
    - PhotoCaptureContent
      - `question` string
      - `instructions` string
      - `context` string
      - `prompt` string, required
  - `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

## Other responses

- `401`: Missing or invalid authentication
- `404`: Resource not found

---

[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)