---
title: "List interviews"
method: GET
path: "/api/public/v1/interviews"
tags: ["Public API v1", "Public API v1"]
---

# List interviews

`GET /api/public/v1/interviews`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/public/v1/interviews`
- Auth: HTTP bearer

List interviews for your organization with pagination. Filter by status, candidate email, role, or date range.

## Query parameters

- `status` string, nullable: Filter by overall status: pending, processing, completed, failed.
- `candidate_email` string, nullable: Filter by candidate email address (exact match).
- `role` string, nullable: Filter by role (case-insensitive partial match).
- `created_after` string, nullable: Filter interviews created after this ISO 8601 datetime.
- `created_before` string, nullable: Filter interviews created before this ISO 8601 datetime.
- `limit` integer: Number of results per page.
- `offset` integer: Offset for pagination.

## Response `200`

Successful Response

- BackendRoutersPublicApiInterviewListResponse: Paginated list of interviews.
  - `interviews` InterviewListItem[], required: List of interviews.
    - `id` string, required: Unique interview ID.
    - `status` string, required: 'pending', 'processing', 'completed', 'failed'.
    - `transcript_status` string, required: Transcription sub-status.
    - `analysis_status` string, required: Analysis sub-status.
    - `input_mode` string, required: 'meeting' or 'recording'.
    - `created_at` string, required: ISO 8601 timestamp.
    - `candidate` CandidateInfo, required: Candidate identification.
      - `id` string, required: Candidate ID. Use for subsequent interviews and debriefs.
      - `name` string, required: Candidate full name.
      - `email` string, nullable: Candidate email.
    - `role` string, required: Job role.
    - `overall_score` integer, nullable: Overall score 0-100 (if completed).
    - `recommendation` string, nullable: Hiring recommendation (if completed).
    - `metadata` object, nullable: Custom metadata from submission.
    - `error` string, nullable: Error message if failed.
  - `total` integer, required: Total number of interviews matching the query.
  - `limit` integer, required: Number of results per page.
  - `offset` integer, required: Current offset in the result set.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)