GET /interviews to retrieve all interview sessions associated with your account. Results are paginated and can be filtered by status, role, or date. This endpoint is useful for building dashboards, syncing data to your ATS, or auditing past interviews.
Endpoint
Query Parameters
string
Filter results by interview status. Accepted values:
scheduled, in_progress, completed, expired. Omit this parameter to return all statuses.string
Filter results by the job role string (e.g.,
"AI Engineer"). The match is case-insensitive.string
Return only interviews created on or after this date. Use ISO 8601 format:
YYYY-MM-DD (e.g., "2025-09-01").string
Return only interviews created on or before this date. Use ISO 8601 format:
YYYY-MM-DD (e.g., "2025-09-30").integer
default:"1"
The page number to retrieve. Defaults to
1.integer
default:"20"
Number of results to return per page. Defaults to
20. Maximum is 100.Example Request
Retrieve the second page of completed interviews for the"AI Engineer" role in September 2025:
Response
A successful200 OK response returns a paginated envelope:
array
An array of interview session objects. Each object contains the same fields as the Retrieve Interview response:
interview_id, candidate_name, candidate_email, role, interview_type, evaluation_level, status, interviewUrl, expires_at, and created_at.integer
The total number of interview sessions matching your filters, across all pages.
integer
The current page number returned.
integer
The number of results returned per page.