---
title: "List interview sessions across all users (admin)"
method: GET
path: "/api/users/interviews"
tags: ["Interviews"]
---

# List interview sessions across all users (admin)

`GET /api/users/interviews`

Returns a filterable, paginated list of interview sessions across all
users. Requires `admin`, `advocate`, or the `access_sessions` permission.

## Query parameters

- `user_id` integer
- `secret` string
- `i` string
- `session` string
- `query` string
- `tag` string
- `include_dictionary` 0 | 1
- `next_id` string

## Response `200`

Paginated list of interview sessions.

- InterviewSessionList
  - `next_id` string, nullable, required — Opaque token to pass as `next_id` to retrieve the next page. `null` when no further pages exist.
  - `items` InterviewSession[], required
    - `email` string
    - `filename` string
    - `metadata` object
    - `modtime` string
    - `session` string
    - `starttime` string
    - `subtitle` string, nullable
    - `tags` string[]
    - `temp_user_id` integer, nullable
    - `title` string
    - `user_id` integer, nullable
    - `utc_modtime` string
    - `utc_starttime` string
    - `valid` boolean
    - `dict` object — Interview answers (only present when include_dictionary=1).
    - `encrypted` boolean — Whether answers are encrypted (only present when include_dictionary=1).

## Other responses

- `400` — Error getting interview list.
- `403` — Access denied.

---

[API](https://skmtc.net/docassemble/apis/docassemble-api.md) · [All operations](https://skmtc.net/docassemble/apis/docassemble-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docassemble/docassemble-api/versions/a75d7eea6826/schema)