> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getversive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Review study

> Check whether a study is ready to share, and how long it takes

Checks a study before you share its link: whether participants can take it, how long the interview runs, and what could be improved. The checks are deterministic and read-only; nothing is changed.

**id** `string` *required*

The study ID.

### Response

**study\_id** `string`

The study ID.

**title** `string`

The study title.

**status** `string`

The study status (e.g. `published`, `paused`).

**mode** `string`

The interview mode (e.g. `TEXT_ONLY`, `VIDEO`).

**ready** `boolean`

`false` while any finding has severity `blocker`.

**question\_count** `integer`

Active questions in the study.

**estimated\_minutes** `object | null`

`{ min_minutes, max_minutes }`, or `null` when the study has no questions.

**estimate\_basis** `string | null`

`longest_path` (the longest route through the study's branching) or `all_questions` (a sum of every question, used when no branching data exists yet).

**findings** `array`

**properties**

**code** `string`

`not_published`, `empty_study`, `prototype_goal_equals_start` (blockers); `empty_prompt`, `high_burden` (warnings); `over_length`, `desktop_only_recommended`, `mergeable_ai_questions` (suggestions).

**severity** `string`

`blocker`, `warning`, or `suggestion`.

**message** `string`

What was found.

**suggestion** `string`

The suggested fix.

**question\_ids** `string[]`

The questions involved, when the finding is about specific questions.

**judgment\_checks** `string[]`

Wording and design checks that need someone reading the questions (leading or double-barreled wording, order, sample size).

```bash cURL theme={null}
curl https://api.getversive.com/api/v1/studies/9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b/review \
  -H "Authorization: Bearer $VERSIVE_API_KEY"
```

```json 200 theme={null}
{
  "study_id": "9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b",
  "title": "Checkout feedback",
  "status": "published",
  "mode": "TEXT_ONLY",
  "ready": true,
  "question_count": 8,
  "estimated_minutes": { "min_minutes": 4.4, "max_minutes": 11.7 },
  "estimate_basis": "longest_path",
  "findings": [
    {
      "code": "desktop_only_recommended",
      "severity": "suggestion",
      "message": "The study has content that is hard to use on a phone (websiteTest) but does not require a desktop.",
      "suggestion": "Set the study's device requirement to desktop."
    }
  ],
  "judgment_checks": [
    "Wording: one ask per question (split double-barreled ones) and no leading or loaded phrasing."
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.