> ## 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 Single Response

> This endpoint retrieves a single response for a specific study.

<Note>
  Deprecated starting **August 1, 2026**. Use
  [`GET /api/public/v1/responses/{linkId}/{responseId}`](/api-v2/get-response)
  instead.
</Note>

### Path Parameters

<ParamField path="link_id" type="string">
  The link ID of the study. You can find this in the study URL or via the List Studies endpoint.
  For example, in `https://listenlabs.ai/s/abc123` the link ID is `abc123`.
</ParamField>

<ParamField path="response_id" type="string">
  The unique ID of the specific response you want to retrieve.
</ParamField>

### Response

Returns a single response with detailed information:

<ResponseField name="id" type="string">
  Unique identifier for the response.
</ResponseField>

<ResponseField name="survey" type="string">
  The link ID of the survey this response belongs to.
</ResponseField>

<ResponseField name="transcript" type="array">
  A complete transcript of the conversation, with each entry containing:

  <Expandable title="Transcript Entry Structure">
    <ResponseField name="moderator" type="string">
      The message from the assistant/moderator.
    </ResponseField>

    <ResponseField name="user" type="string">
      The response from the user.
    </ResponseField>

    <ResponseField name="discussion_guide_question_id" type="string">
      The discussion guide question ID for this row. Matches the `id` field from the Get Study Questions endpoint, enabling you to join transcript rows with their question definitions.
    </ResponseField>

    <ResponseField name="concept_id" type="string | null">
      The concept ID for this row. Null if the question isn't concept-specific.
    </ResponseField>

    <ResponseField name="answer_id" type="string | null">
      The answer ID for this question. Matches the `answer_id` in the list endpoint's `answers_array`, enabling cross-referencing between transcript rows and extracted answers. Null for non-question rows (e.g. intro messages).
    </ResponseField>

    <ResponseField name="response_index" type="number">
      The zero-based index of this row in the conversation history.
    </ResponseField>

    <ResponseField name="is_followup" type="boolean">
      Whether this row is a follow-up to the same question as the previous row.
    </ResponseField>

    <ResponseField name="audio" type="string | null">
      A signed URL to the audio recording of the user's response, if available.
      This URL is valid for 1 hour. Null if no audio recording exists.
    </ResponseField>

    <ResponseField name="video" type="object | null">
      Video playback information, if available. Null if no video recording exists.

      <Expandable title="Video Object">
        <ResponseField name="stream_url" type="string">
          HLS stream URL for the video recording.
        </ResponseField>

        <ResponseField name="mp4_url" type="string">
          Direct MP4 download URL for the video recording.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="question_uuid" type="string" deprecated>
      Deprecated. Use `discussion_guide_question_id` instead.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Example Request theme={null}
  curl 'https://listenlabs.ai/api/public/responses/study-1/12345678-0000-0000-0000-000000000000' \
  -H 'x-api-key: <api_key>'
  ```
</RequestExample>

<ResponseExample>
  ```json Response - Audio and Text theme={null}
  {
    "id": "12345678-0000-0000-0000-000000000000",
    "survey": "audio-survey",
    "transcript": [
      {
        "moderator": "Welcome to our audio survey. Can you describe your experience with our product?",
        "user": "The product has been very helpful for our team's workflow.",
        "discussion_guide_question_id": "a1b2c3d4-0000-0000-0000-000000000001",
        "concept_id": null,
        "answer_id": "f1e2d3c4-0000-0000-0000-000000000001",
        "response_index": 0,
        "is_followup": false,
        "audio": "https://storage.listenlabs.ai/audio/responses/abc123.mp3?token=...",
        "video": null,
        "question_uuid": "a1b2c3d4-0000-0000-0000-000000000001"
      },
      {
        "moderator": "What specific features do you find most useful?",
        "user": "The task management and integration capabilities are standouts for us.",
        "discussion_guide_question_id": "a1b2c3d4-0000-0000-0000-000000000002",
        "concept_id": "b2c3d4e5-0000-0000-0000-000000000001",
        "answer_id": "f1e2d3c4-0000-0000-0000-000000000002",
        "response_index": 1,
        "is_followup": false,
        "audio": "https://storage.listenlabs.ai/audio/responses/def456.mp3?token=...",
        "video": null,
        "question_uuid": "a1b2c3d4-0000-0000-0000-000000000002"
      }
    ]
  }
  ```

  ```json Response - Video and Text theme={null}
  {
    "id": "23456789-0000-0000-0000-000000000000",
    "survey": "video-interview",
    "transcript": [
      {
        "moderator": "Tell us about your background in the industry.",
        "user": "I've been working in software development for over 10 years, primarily focusing on frontend technologies.",
        "discussion_guide_question_id": "a1b2c3d4-0000-0000-0000-000000000001",
        "concept_id": null,
        "answer_id": "f1e2d3c4-0000-0000-0000-000000000001",
        "response_index": 0,
        "is_followup": false,
        "audio": null,
        "video": {
          "stream_url": "https://stream.mux.com/vWx123.m3u8",
          "mp4_url": "https://stream.mux.com/vWx123/capped-1080p.mp4"
        },
        "question_uuid": "a1b2c3d4-0000-0000-0000-000000000001"
      },
      {
        "moderator": "What attracted you to our company?",
        "user": "Your focus on innovative solutions and strong company culture really resonated with me.",
        "discussion_guide_question_id": "a1b2c3d4-0000-0000-0000-000000000002",
        "concept_id": null,
        "answer_id": "f1e2d3c4-0000-0000-0000-000000000002",
        "response_index": 1,
        "is_followup": false,
        "audio": null,
        "video": {
          "stream_url": "https://stream.mux.com/yZ456.m3u8",
          "mp4_url": "https://stream.mux.com/yZ456/capped-1080p.mp4"
        },
        "question_uuid": "a1b2c3d4-0000-0000-0000-000000000002"
      }
    ]
  }
  ```

  ```json Response - Text Only theme={null}
  {
    "id": "34567890-0000-0000-0000-000000000000",
    "survey": "text-feedback",
    "transcript": [
      {
        "moderator": "How would you rate your satisfaction with our customer service?",
        "user": "I would rate it 9/10. Your support team was quick to respond and very helpful.",
        "discussion_guide_question_id": "a1b2c3d4-0000-0000-0000-000000000001",
        "concept_id": null,
        "answer_id": "f1e2d3c4-0000-0000-0000-000000000001",
        "response_index": 0,
        "is_followup": false,
        "audio": null,
        "video": null,
        "question_uuid": "a1b2c3d4-0000-0000-0000-000000000001"
      },
      {
        "moderator": "What suggestions do you have for improvement?",
        "user": "It would be nice to have weekend support hours for urgent issues.",
        "discussion_guide_question_id": "a1b2c3d4-0000-0000-0000-000000000002",
        "concept_id": null,
        "answer_id": "f1e2d3c4-0000-0000-0000-000000000002",
        "response_index": 1,
        "is_followup": false,
        "audio": null,
        "video": null,
        "question_uuid": "a1b2c3d4-0000-0000-0000-000000000002"
      }
    ]
  }
  ```
</ResponseExample>