GET /external/v1/studiesList Study metadata, format, Prototype stimulus, response counts, typed feedback configuration, accepted work context, and bounded draft-readiness counts. Use draftReadiness.hasBuilderContent instead of assuming that a draft with no responses or linked work is empty. Research answers, participant identity, prompts, and step content are excluded. Follow X-Has-More and advance offset by X-Limit to retrieve the complete catalog.
Requirements
API scopes required:
studies:read
Request
Parameters
| Name | Type | Description |
|---|---|---|
| limit | number | 1–100 results. Defaults to 20. |
| offset | number | Number of results to skip. |
| status | string | Exact Study status. |
| moderationMode | enum | Filter by self_guided, ai_moderated, or live_interview. |
| initiativeId | uuid | Current accepted Initiative context. |
| ideaId | uuid | Current accepted Idea context. |
| updatedSince | iso-date | Only Studies changed at or after this ISO-8601 timestamp, including new evidence, oldest change first. Use it to re-read evidence only for Studies that moved, and dedupe by id. |
Responses
200
SuccessStudies were retrieved.
Schema
Array<Study>
Example Response
200 OK
json
[
{
"id": "study-uuid",
"publicId": "STUDY-8",
"workspaceId": "workspace-uuid",
"name": "Scheduler direction check",
"mainQuestion": "Can customers choose the right appointment type?",
"status": "active",
"type": "heatmap_interaction",
"phase": "validation",
"moderationMode": "live_interview",
"studyFormat": "live_interview",
"usesPrototype": true,
"prototypeStimulus": {
"prototypeId": "prototype-uuid",
"prototypePublicId": "PROTOTYPE-7",
"name": "Scheduling flow",
"revisionId": "prototype-revision-uuid",
"revisionNumber": 3,
"status": "ready"
},
"responseCount": 7,
"draftReadiness": {
"hasBuilderContent": true,
"stepCount": 2,
"questionCount": 1,
"interviewTopicCount": 4,
"hasDecisionToInform": true,
"hasLearningQuestion": true
},
"feedback": {
"enabled": true,
"prompt": "How clear was this interview?",
"metric": "study_experience_clarity",
"subject": {
"type": "study",
"id": "study-uuid"
},
"responseCount": 6,
"averageRating": 4.17
},
"contexts": [
{
"linkId": "study-context-link-uuid",
"entityType": "initiative",
"entityId": "initiative-uuid",
"publicId": "INITIATIVE-42",
"label": "Unified scheduling",
"productId": "product-uuid",
"productName": "Denticon"
}
],
"initiativeIds": [
"initiative-uuid"
],
"ideaIds": [],
"appPath": "/studies/STUDY-8",
"createdAt": "2026-07-01T00:00:00Z",
"updatedAt": "2026-07-14T10:00:00Z"
}
]