Get Single Response

This endpoint retrieves a single response for a specific study.

GET /api/public/responses/{link_id}/{response_id}

Example Request

curl 'https://listenlabs.ai/api/public/responses/study-1/12345678-0000-0000-0000-000000000000' \
-H 'x-api-key: <api_key>'

Response - Audio and Text

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

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:

Show 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.

Show 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.

Example Request

curl 'https://listenlabs.ai/api/public/responses/study-1/12345678-0000-0000-0000-000000000000' \
-H 'x-api-key: <api_key>'

Response - Audio and Text

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