List studies

GET /v1/api/studies Requires studies:read

List your organisation's studies, newest first. A study is one research project: an AI-moderated interview Juno designs and runs, plus the analysis built from the answers. Page through with limit and offset.

Parameters

limit query

integer

Page size — newest studies first, max 200.

offset query

integer

Rows to skip for pagination.

Responses

200 Successful Response

array of

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.

422 Validation Error

ValidationError[]

cURL

curl 'https://api.heyjuno.co/v1/api/studies?limit=50&offset=0' \
  -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"
  }
]