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",
"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"
}
]
}
{
"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"
}
]
}
{
"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"
}
]
}
Get Single Response
This endpoint retrieves a single response for a specific study.
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",
"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"
}
]
}
{
"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"
}
]
}
{
"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"
}
]
}
Path Parameters
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.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.
string
The link ID of the survey this response belongs to.
array
A complete transcript of the conversation, with each entry containing:
Show Transcript Entry Structure
Show Transcript Entry Structure
string
The message from the assistant/moderator.
string
The response from the user.
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.string | null
The concept ID for this row. Null if the question isn’t concept-specific.
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).number
The zero-based index of this row in the conversation history.
boolean
Whether this row is a follow-up to the same question as the previous row.
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.
object | null
string
deprecated
Deprecated. Use
discussion_guide_question_id instead.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",
"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"
}
]
}
{
"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"
}
]
}
{
"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"
}
]
}