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",
      "audio": "https://storage.listenlabs.ai/audio/responses/abc123.mp3?token=...",
      "video": null
    },
    {
      "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",
      "audio": "https://storage.listenlabs.ai/audio/responses/def456.mp3?token=...",
      "video": null
    }
  ]
}

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.

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

audio · string

A signed URL to the audio recording of the user’s response, if available. This URL is valid for 1 hour. If no audio recording exists, this will be null.

video · object

Video playback information, if available. If no video recording exists, this will be null.

Show Video Object

stream_url · string

HLS stream URL for the video recording.

mp4_url · string

Direct MP4 download URL for the video recording.

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",
      "audio": "https://storage.listenlabs.ai/audio/responses/abc123.mp3?token=...",
      "video": null
    },
    {
      "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",
      "audio": "https://storage.listenlabs.ai/audio/responses/def456.mp3?token=...",
      "video": null
    }
  ]
}