Public API v1
Public API v1

List interviews

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

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

Query parameters

statusstring nullable

Filter by overall status: pending, processing, completed, failed.

candidate_emailstring nullable

Filter by candidate email address (exact match).

rolestring nullable

Filter by role (case-insensitive partial match).

created_afterstring nullable

Filter interviews created after this ISO 8601 datetime.

created_beforestring nullable

Filter interviews created before this ISO 8601 datetime.

limitinteger

Number of results per page.

offsetinteger

Offset for pagination.

Response

Successful Response

totalinteger required

Total number of interviews matching the query.

limitinteger required

Number of results per page.

offsetinteger required

Current offset in the result set.

Changes

No recorded changes to this operation across all 1 revision of this API.