Get Single Response - Listen Labs

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

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

GET

api

public

responses

{link_id}

{response_id}

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

{
  "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:

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.

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

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

Get Responses

Endpoints

​Path Parameters

​Response

Path Parameters

Response