curl "https://api.getversive.com/api/v1/questions?study_id=9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b" \
-H "Authorization: Bearer $VERSIVE_API_KEY"
{
"id": "<string>",
"content": "<string>",
"type": "<string>",
"interviewer_notes": {},
"display_order": 123,
"props": {},
"assets": {},
"logic": [
{}
],
"mentions": [
{}
]
}Questions
List questions
List a study’s questions with logic and mentions
GET
/
questions
curl "https://api.getversive.com/api/v1/questions?study_id=9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b" \
-H "Authorization: Bearer $VERSIVE_API_KEY"
{
"id": "<string>",
"content": "<string>",
"type": "<string>",
"interviewer_notes": {},
"display_order": 123,
"props": {},
"assets": {},
"logic": [
{}
],
"mentions": [
{}
]
}Returns all questions in a study, ordered by
Use
display_order, each with its logic rules and resolved mentions.
string
required
The study whose questions to list.
Response
An array of question objects:string
Question ID.
string
The question text (may include
{{Q:...}} reference placeholders).string
Question type — e.g.
question (AI Question), textInput, shortText, message, email, multipleChoice, ratingScale, matrixRatingScale, starRating, nps, number, ranking, rankingWithMatrix, cardSort, allocation, allocationWithMatrix, conjoint, treeTest, prototypeTask, websiteTest, externalLink, calendar, mediaUpload, exploratory. Write endpoints accept type as a free-form string; these are the types the Versive app uses.string | null
Private notes guiding the AI interviewer.
integer
Position in the study.
object
Type-specific settings (options, scales, limits, and so on).
object[] | null
Attached media assets. Each asset keeps its stable
url identifier and includes download_url for viewing
or downloading it. Private storage links last one hour; download_url_expires_at is their UTC expiry time.
Request this endpoint again for a fresh link. External URLs are passed through and have no expiry time.
If a private file cannot be signed, both download fields are null; the rest of the response remains available.download_url to fetch the file. When updating a question, retain the asset’s url identifier and omit
the read-only download_url and download_url_expires_at fields. A private asset’s identifier may contain
/object/public/; it identifies the stored file but cannot be used as a public download link.
object[]
The question’s logic rules — same shape as question logic.
object[]
Resolved
{{Q:...}} references in the content: placeholder, referenced_question_id, label, type (question | propertyAnswer), property_name, property_index, valid, error.curl "https://api.getversive.com/api/v1/questions?study_id=9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b" \
-H "Authorization: Bearer $VERSIVE_API_KEY"