Get study

GET /v1/api/studies/{study_id} Requires studies:read

Fetch one study, including its current brief — the study design Juno authored: title, objectives, and the questions the interviewer asks. The brief is null until an authoring job has completed.

Parameters

study_id path required

string <uuid>

Responses

200 Successful Response

id

string <uuid> required

Unique study id. Use it in every study-scoped call.

name

string required

Human-readable study name, as shown in the Juno app.

mode

enum("test", "live", "paused", "closed") required

Current lifecycle value. 'test' means Test mode: the user can simulate the interview shape with no credits, analysis, or exports; it is not for real participant research. 'live' means Live mode: real participant interviews deduct credits and enable analysis and exports. 'paused' and 'closed' are technical collection states. Use PUT /v1/api/studies/{study_id}/mode; mode='live' is the API equivalent of the user selecting Go live.

launched_at

string <date-time> · nullable required

When the study first went live. Null if it never has.

created_at

string <date-time> required

When the study was created.

updated_at

string <date-time> required

When the study last changed.

Brief · nullable

The study's current brief. Null only while nothing has been authored yet (an authoring job is still working).

422 Validation Error

ValidationError[]

cURL

curl 'https://api.heyjuno.co/v1/api/studies/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Authorization: Bearer $JUNO_API_KEY'

Example response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "mode": "test",
  "launched_at": "2026-01-01T00:00:00Z",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z",
  "brief": {
    "title": "string",
    "objectives": [
      "string"
    ],
    "pre_interview_questions": [
      "string"
    ],
    "verbatim_questions": [
      "string"
    ],
    "estimated_duration_minutes": 0
  }
}