Juno
API reference

List interviews

list_interviews Requires export:read

List participant interviews, newest first — use this 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; use start_export for full data. Filter by study_id and status, and page by passing the next_cursor from the previous response. Check is_test before acting: Test-mode rehearsals are listed too.

Input

study_id
string | null

Only return interviews belonging to this study.

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

Only return interviews in this state. Use 'completed' to watch for finished interviews.

cursor
string | null

Opaque cursor from the previous page's X-Next-Cursor header. Omit for the first page. Cursors are keyset-based, so rows arriving mid-pagination never shift or duplicate the page you are walking.

limit
integer

Page size — newest first, max 200.

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_interviews",
    "arguments": {
      "study_id": null,
      "status": null,
      "cursor": null,
      "limit": 50
    }
  }
}