---
title: "Get study creation job status"
method: GET
path: "/v1/studies/jobs/{job_id}"
tags: ["Studies"]
---

# Get study creation job status

`GET /v1/studies/jobs/{job_id}`

Poll the status of a study creation job. Returns `processing` while the study is being generated, `completed` with the study ID when done, or `failed` if an error occurred.

## Path parameters

- `job_id` string, required

## Response `200`

Job completed or failed

- JobStatusResponse
  - `analyze_done` integer, nullable
  - `analyze_item_elapsed_ms` integer, nullable
  - `analyze_item_expected_ms` integer, nullable
  - `analyze_total` integer, nullable
  - `analyze_video_seconds` integer, nullable
  - `error_message` string, nullable
  - `has_analyzing_media` boolean, nullable
  - `has_deliberation` boolean, nullable
  - `has_enriched_context` boolean, nullable
  - `has_life_stories` boolean, nullable
  - `has_media` boolean, nullable
  - `has_qualitative_questions` boolean, nullable
  - `jury_panel_size` integer, nullable
  - `media_done` integer, nullable
  - `media_item_elapsed_ms` integer, nullable
  - `media_item_expected_ms` integer, nullable
  - `media_total` integer, nullable
  - `number_participants` integer, nullable
  - `phase` string, nullable
  - `phase_entered_at_ms` integer, nullable
  - `progress` number, nullable
  - `qual_questions_count` integer, nullable
  - `status` 'processing' | 'preparing_context' | 'completed' | 'failed', required
  - `study_id` string, nullable
  - `title` string, nullable

## Other responses

- `202` — Job still processing
- `400` — Bad request
- `401` — Authentication failed
- `404` — Job not found

## Changes

- **2026-08-31** `4265e26dc983` — 2 info
  - added the optional property `has_deliberation` to the response with the `200` status
  - added the optional property `has_deliberation` to the response with the `202` status

[Change history](https://skmtc.dev/viewpoints/apis/viewpoints-study-api/changes/v1/studies/jobs/:job_id/get.md)

---

[API](https://skmtc.dev/viewpoints/apis/viewpoints-study-api.md) · [All operations](https://skmtc.dev/viewpoints/apis/viewpoints-study-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/viewpoints/viewpoints-study-api/revisions/4265e26dc983/schema)