Skip to main content
GET
List interviews

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <token>. The token is either a user token / OAuth access token, or a service-account API key (cfk_...). A key is valid on every endpoint and acts as its service account, an organization member with per-store permissions. Refused keys answer 403 with Invalid API key., API key revoked., API key expired. or API key disabled..

Path Parameters

project_id
string<uuid>
required

UUID of the project

Query Parameters

assigned_to
enum<string>

Set to "me" to return only interviews assigned to (or created by) the requesting user.

Available options:
me
created_by
enum<string>

Set to "me" to return only interviews the requesting user created (whoever they were assigned to).

Available options:
me
status
string

Filter by status. Comma-separated for multiple values (e.g. "pending,in_progress").

type
string

Filter by conversation type. interview returns every interview type (standard, guided, onboarding, imported) and no meetings; meeting returns the meetings Clara attended (present only once the call is over and transcribed — a live meeting has no conversation yet); any other value is matched exactly (e.g. imported-interview, onboarding). Omitting it lists everything except meetings and Clara Fast sessions, which have their own pages; both remain retrievable by id.

campaign
string

Filter by campaign: a campaign UUID for that campaign's interviews, or the literal "none" for interviews without a campaign.

text
string

Case-insensitive search over the interview name and transcript.

ordering
enum<string>

Sort order. Omit for the default: newest first, where an interview in a campaign sorts by its campaign's creation date (keeping a campaign's interviews together) and a campaign-less one by its own.

status sorts unfinished interviews first and completed ones last, newest first within each — intended for listing one campaign's interviews, where "who still hasn't finished" is the question.

Available options:
status
limit
integer
default:100

Maximum number of results per page

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of results to skip for pagination

Required range: x >= 0

Response

Successful response

count
integer

Total number of results

next
string<uri> | null

URL to next page of results

previous
string<uri> | null

URL to previous page of results

results
object[]
status_counts
object

Number of interviews per status across the whole filtered set (not just the returned page). Keys are the status values ("pending", "in_progress", "completed"); legacy conversations without a status are counted under "none". Absent keys mean zero.