Get interview

GET /v1/api/interviews/{interview_id} Requires export:read

Fetch one interview by id. Same projection as List interviews: state, timings, invite-link values, and a permalink — no transcript or participant identity. Use Start an export for the full transcript data.

Parameters

interview_id path required

string <uuid>

Responses

200 Successful Response

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/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -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"
}