> ## Documentation Index
> Fetch the complete documentation index at: https://docs.listenlabs.com/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.

### Path Parameters

**link\_id** `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`.

**response\_id** `string`

The unique ID of the specific response you want to retrieve.

### Response

Returns a single response with detailed information:

**id** `string`

Unique identifier for the response.

**survey** `string`

The link ID of the survey this response belongs to.

**transcript** `array`

A complete transcript of the conversation, with each entry containing:

**Transcript Entry Structure**

**moderator** `string`

The message from the assistant/moderator.

**user** `string`

The response from the user.

**discussion\_guide\_question\_id** `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.

**concept\_id** `string | null`

The concept ID for this row. Null if the question isn't concept-specific.

**answer\_id** `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).

**response\_index** `number`

The zero-based index of this row in the conversation history.

**is\_followup** `boolean`

Whether this row is a follow-up to the same question as the previous row.

**audio** `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.

**video** `object | null`

Video playback information, if available. Null if no video recording exists.

**Video Object**

**stream\_url** `string`

HLS stream URL for the video recording.

**mp4\_url** `string`

Direct MP4 download URL for the video recording.

**question\_uuid** `string` *deprecated*

Deprecated. Use `discussion_guide_question_id` instead.

```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>'
```

```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"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.