curl https://api.getversive.com/api/v1/studies/length-estimate \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "TEXT_ONLY",
"questions": [
{ "type": "question" },
{ "type": "multipleChoice" },
{ "type": "exploratory", "props": { "turnBudget": 12 } },
{ "type": "message", "props": { "requireTimer": true, "timer": 30 } },
{ "type": "nps", "required": false }
]
}'
{
"mode": "TEXT_ONLY",
"question_count": 5,
"estimated_minutes": { "min_minutes": 4.6, "max_minutes": 11.5 },
"mode_overhead_seconds": 10,
"questions": [
{ "index": 0, "type": "question", "required": true, "min_seconds": 55, "max_seconds": 150 },
{ "index": 1, "type": "multipleChoice", "required": true, "min_seconds": 10, "max_seconds": 25 },
{ "index": 2, "type": "exploratory", "required": true, "min_seconds": 165, "max_seconds": 450 },
{ "index": 3, "type": "message", "required": true, "min_seconds": 35, "max_seconds": 45 },
{ "index": 4, "type": "nps", "required": false, "min_seconds": 3, "max_seconds": 9 }
],
"note": "A straight sum over every planned question: there is no branching at plan time, so participants who skip questions through logic finish sooner. Optional questions count at 60%. Once the study is built, review_study gives the estimate for its longest path."
}
Studies
Estimate study length
How long a planned study will take, before you build it
POST
/
studies
/
length-estimate
curl https://api.getversive.com/api/v1/studies/length-estimate \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "TEXT_ONLY",
"questions": [
{ "type": "question" },
{ "type": "multipleChoice" },
{ "type": "exploratory", "props": { "turnBudget": 12 } },
{ "type": "message", "props": { "requireTimer": true, "timer": 30 } },
{ "type": "nps", "required": false }
]
}'
{
"mode": "TEXT_ONLY",
"question_count": 5,
"estimated_minutes": { "min_minutes": 4.6, "max_minutes": 11.5 },
"mode_overhead_seconds": 10,
"questions": [
{ "index": 0, "type": "question", "required": true, "min_seconds": 55, "max_seconds": 150 },
{ "index": 1, "type": "multipleChoice", "required": true, "min_seconds": 10, "max_seconds": 25 },
{ "index": 2, "type": "exploratory", "required": true, "min_seconds": 165, "max_seconds": 450 },
{ "index": 3, "type": "message", "required": true, "min_seconds": 35, "max_seconds": 45 },
{ "index": 4, "type": "nps", "required": false, "min_seconds": 3, "max_seconds": 9 }
],
"note": "A straight sum over every planned question: there is no branching at plan time, so participants who skip questions through logic finish sooner. Optional questions count at 60%. Once the study is built, review_study gives the estimate for its longest path."
}
Estimates how long a study will take from its interview mode and planned questions, before the study exists. Nothing is created. Requires the
An unknown question type or mode, an empty plan, or a timing value out of range returns
studies:read scope.
Timings come from Versive’s per-question timing model, calibrated on production interviews. The estimate adds up every planned question in order, plus a one-time setup allowance for the mode. A plan has no logic yet, so participants who skip questions through branching finish sooner. Optional questions count at 60% of their time.
Once the study is built, its estimated length follows the longest path through its logic.
Body
string
required
The interview mode:
TEXT_ONLY, TEXT_AND_VOICE, VOICE_ONLY, VOICE_WITH_PREVIEW, VIDEO, VOICE_AND_VIDEO, or VOICE_TO_VOICE.array
required
The planned questions in order, 1 to 200.
Show properties
Show properties
string
required
The question type, e.g.
question, exploratory, multipleChoice, nps, websiteTest.boolean
false for an optional question. Defaults to true.object
Timing inputs only:
turnBudget (2–25) for an exploratory question, defaulting to 8 turns; requireTimer and timer (1–3600 seconds) for a message with a required wait.Response
string
The mode the estimate used.
integer
Number of planned questions.
object
{ min_minutes, max_minutes }: the estimated length range in minutes.integer
The one-time setup allowance included for the mode.
array
One
{ index, type, required, min_seconds, max_seconds } per planned question, in order.string
How to read the estimate.
422.
curl https://api.getversive.com/api/v1/studies/length-estimate \
-H "Authorization: Bearer $VERSIVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mode": "TEXT_ONLY",
"questions": [
{ "type": "question" },
{ "type": "multipleChoice" },
{ "type": "exploratory", "props": { "turnBudget": 12 } },
{ "type": "message", "props": { "requireTimer": true, "timer": 30 } },
{ "type": "nps", "required": false }
]
}'
{
"mode": "TEXT_ONLY",
"question_count": 5,
"estimated_minutes": { "min_minutes": 4.6, "max_minutes": 11.5 },
"mode_overhead_seconds": 10,
"questions": [
{ "index": 0, "type": "question", "required": true, "min_seconds": 55, "max_seconds": 150 },
{ "index": 1, "type": "multipleChoice", "required": true, "min_seconds": 10, "max_seconds": 25 },
{ "index": 2, "type": "exploratory", "required": true, "min_seconds": 165, "max_seconds": 450 },
{ "index": 3, "type": "message", "required": true, "min_seconds": 35, "max_seconds": 45 },
{ "index": 4, "type": "nps", "required": false, "min_seconds": 3, "max_seconds": 9 }
],
"note": "A straight sum over every planned question: there is no branching at plan time, so participants who skip questions through logic finish sooner. Optional questions count at 60%. Once the study is built, review_study gives the estimate for its longest path."
}