> ## Documentation Index
> Fetch the complete documentation index at: https://docs.listenlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Study Questions

> This endpoint retrieves all questions for a specific study.

### Path Parameters

<ParamField path="study_id" type="string" required>
  The link ID of the study you want to retrieve questions for. You can find this in the study URL or via the List Studies endpoint.
</ParamField>

### Response

Returns an object containing a list of questions from the study's latest revision. Each question includes its type and relevant metadata.

<ResponseField name="questions" type="array">
  An array of question objects. Each question has a `type` field that determines its shape.

  <Expandable title="Question Types">
    #### Common Fields

    All question types share these base fields:

    <ResponseField name="id" type="string">
      Unique identifier for the question. Matches the `discussion_guide_question_id` field in the response endpoints, enabling you to join questions with their corresponding transcript rows and answers.
    </ResponseField>

    <ResponseField name="text" type="string">
      The question text shown to participants.
    </ResponseField>

    <ResponseField name="is_screener" type="boolean">
      Whether this question is part of the screening section.
    </ResponseField>

    <ResponseField name="type" type="string">
      The question type. One of: `open_ended`, `multiple_choice`, `ranking`, `statement`.
    </ResponseField>

    <ResponseField name="question_number" type="number">
      The human-readable question number for display purposes.
    </ResponseField>

    <ResponseField name="concepts" type="array">
      An array of concept objects attached to this question (empty if the question is not part of a concept test block).

      <Expandable title="Concept Object">
        <ResponseField name="id" type="string">
          Unique identifier for the concept.
        </ResponseField>

        <ResponseField name="title" type="string">
          The concept title.
        </ResponseField>

        <ResponseField name="description" type="string">
          The concept description.
        </ResponseField>

        <ResponseField name="media" type="array">
          An array of media attachments.

          <Expandable title="Media Object">
            <ResponseField name="type" type="string">
              The media type. One of: `image`, `video`.
            </ResponseField>

            <ResponseField name="name" type="string">
              The file name of the media.
            </ResponseField>

            <ResponseField name="url" type="string">
              The URL of the media file.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="embed_url" type="string | null">
          An optional embed URL for the concept (e.g. a Figma or prototype link).
        </ResponseField>
      </Expandable>
    </ResponseField>

    #### Multiple Choice Questions

    Multiple choice questions (including scale questions) additionally include:

    <ResponseField name="is_multi_select" type="boolean">
      Whether the participant can select multiple options.
    </ResponseField>

    <ResponseField name="options" type="string[]">
      The list of answer options.
    </ResponseField>

    #### Ranking Questions

    Ranking questions additionally include:

    <ResponseField name="options" type="string[]">
      The list of items to rank.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Example Request theme={null}
  curl 'https://listenlabs.ai/api/public/studies/my-study/questions' \
  -H 'x-api-key: <api_key>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "questions": [
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000001",
        "text": "What is your age range?",
        "is_screener": true,
        "question_number": 1,
        "type": "multiple_choice",
        "is_multi_select": false,
        "options": ["18-24", "25-34", "35-44", "45-54", "55+"],
        "concepts": []
      },
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000002",
        "text": "Tell us about your experience with our product.",
        "is_screener": false,
        "question_number": 2,
        "type": "open_ended",
        "concepts": []
      },
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000003",
        "text": "Rank the following features by importance.",
        "is_screener": false,
        "question_number": 3,
        "type": "ranking",
        "options": ["Ease of use", "Performance", "Price", "Customer support"],
        "concepts": []
      },
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000004",
        "text": "Thank you for your feedback. We will now ask about your preferences.",
        "is_screener": false,
        "question_number": 4,
        "type": "statement",
        "concepts": []
      },
      {
        "id": "a1b2c3d4-0000-0000-0000-000000000005",
        "text": "Which categories interest you? Select all that apply.",
        "is_screener": false,
        "question_number": 5,
        "type": "multiple_choice",
        "is_multi_select": true,
        "options": ["Technology", "Health", "Finance", "Education", "Entertainment"],
        "concepts": []
      }
    ]
  }
  ```
</ResponseExample>