curl https://api.getversive.com/api/v1/studies/9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b/quotas/progress \
-H "Authorization: Bearer $VERSIVE_API_KEY"
{
"mode": "fixed",
"fixed": { "limit": 100, "complete": 42 },
"param_name": null,
"buckets": [],
"unmatched_param_policy": "allow",
"question_buckets": [
{
"question_id": "3f1c2a9e-8d4b-4c7a-9e21-5b6d7c8e9f01",
"kind": "choice",
"match": "equals",
"value": "iPhone",
"limit": 25,
"complete": 19
}
]
}
Quotas
Get quota progress
Completes versus limit for every quota bucket
GET
/
studies
/
{id}
/
quotas
/
progress
curl https://api.getversive.com/api/v1/studies/9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b/quotas/progress \
-H "Authorization: Bearer $VERSIVE_API_KEY"
{
"mode": "fixed",
"fixed": { "limit": 100, "complete": 42 },
"param_name": null,
"buckets": [],
"unmatched_param_policy": "allow",
"question_buckets": [
{
"question_id": "3f1c2a9e-8d4b-4c7a-9e21-5b6d7c8e9f01",
"kind": "choice",
"match": "equals",
"value": "iPhone",
"limit": 25,
"complete": 19
}
]
}
Returns the study’s quota configuration together with the current number of completes per bucket. Only completed, real interviews count: in-progress, screened-out, archived, mock, and AI-simulated interviews are excluded.
string
required
The study ID.
Response
string
off, fixed, or url_param.object | null
{ limit, complete } in fixed mode.string | null
The URL parameter in
url_param mode.array
One
{ value, limit, complete } per link value in url_param mode.string
allow or reject.array
One
{ question_id, kind, match, value, limit, complete } per question quota, included in every mode.complete can exceed limit by a small amount when several participants finish at the same time.
curl https://api.getversive.com/api/v1/studies/9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b/quotas/progress \
-H "Authorization: Bearer $VERSIVE_API_KEY"
{
"mode": "fixed",
"fixed": { "limit": 100, "complete": 42 },
"param_name": null,
"buckets": [],
"unmatched_param_policy": "allow",
"question_buckets": [
{
"question_id": "3f1c2a9e-8d4b-4c7a-9e21-5b6d7c8e9f01",
"kind": "choice",
"match": "equals",
"value": "iPhone",
"limit": 25,
"complete": 19
}
]
}