Interviews

List interviews

Find interview attempts for a report or external application, including prior attempts that remain available.

Before you call

Use interviews:read. Optional filters include reportId, lifecycle, or both external-reference fields.

Required scope: interviews:read.

What happens next

Read each attempt independently and follow nextCursor with identical filters. Keep interview IDs separate from report IDs. Fetch a result for an attempt whose evaluation is ready.

Recovery

A completed lifecycle is not proof the evaluation is ready. Filter on lifecycle only to select candidate progress; inspect evaluation separately.

Follow the complete workflow · Errors and retries

get/api/v1/interviews

Request

  • Base URL: https://app.probbai.com
  • URL: https://app.probbai.com/api/v1/interviews
  • Auth: HTTP bearer

Query parameters

reportIdstring

Report ID returned by upload preparation, admission, discovery, or an event. It must belong to the API key's workspace.

lifecycle'invited' | 'in_progress' | 'completed' | 'expired' | 'superseded'

Candidate progress: invited, in_progress, completed, expired, or superseded. Independent of preparation and evaluation.

externalReferenceSourcestring

External source slug. Must be supplied with externalReferenceId.

externalReferenceIdstring

Case-sensitive application ID. Must be supplied with externalReferenceSource.

limitinteger

Page size, 1–100; defaults to 25.

cursorstring

Opaque cursor from the previous page. Repeat all filters unchanged. Never decode or construct a cursor yourself.

Response

Read each attempt independently and follow nextCursor with identical filters. Keep interview IDs separate from report IDs. Fetch a result for an attempt whose evaluation is ready.

Changes

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