List interviews

GET /v1/api/interviews Requires export:read

List participant interviews, newest first — the endpoint to poll to learn when interviews happen. Each entry carries the interview's state, timings, and the values captured from the participant's invite link, plus a link into Juno; transcripts and participant identity are deliberately not included. Filter by study_id and by status, and page with the cursor from the X-Next-Cursor response header (absent on the last page). Check is_test before acting on an interview: Test-mode rehearsals appear here too.

Parameters

study_id query

string <uuid> · nullable

status query

enum("in_progress", "completed", "failed") · nullable

cursor query

string · nullable

limit query

integer

Responses

200 Successful Response

array of

id

string <uuid> required

Unique interview id, stable for the life of the interview. Use it to deduplicate when polling.

study_id

string <uuid> required

The study this interview belongs to.

status

enum("in_progress", "completed", "failed") required

'in_progress' while the participant is still going, 'completed' once the interview ended normally, 'failed' if it errored out.

is_complete

boolean required

True only for 'completed'. Convenient for filtering in one field.

is_test

boolean required

True for Test-mode interviews, which are rehearsals rather than real participant research. Check this before acting on an interview — test runs use no credits and are not real data.

modality

string required

How the participant answered: 'text' or 'voice'.

started_at

string <date-time> required

When the interview record was created.

completed_at

string <date-time> · nullable

When the interview ended. Null while still in progress.

duration_seconds

integer · nullable

Active participant time in seconds, excluding pauses. Null until the runtime has measured any.

entry_attributes

object

Values captured from the participant's invite link — whatever the caller attached when inviting them (a CRM contact id, company, role). The intended way to match an interview back to the record it came from.

invite_audience

enum("group", "person") · nullable

Audience of the contextual participant link used to start this interview: 'group' or 'person'. Null when the interview came from the study's plain link or predates participant-link attribution.

permalink

string required

Absolute URL that opens this interview's transcript in Juno.

422 Validation Error

ValidationError[]

cURL

curl 'https://api.heyjuno.co/v1/api/interviews?study_id=value&status=value&cursor=value&limit=50' \
  -H 'Authorization: Bearer $JUNO_API_KEY'

Example response

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "study_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "in_progress",
    "is_complete": true,
    "is_test": true,
    "modality": "string",
    "started_at": "2026-01-01T00:00:00Z",
    "completed_at": "2026-01-01T00:00:00Z",
    "duration_seconds": 0,
    "entry_attributes": {},
    "invite_audience": "group",
    "permalink": "string"
  }
]