List interviews

GET

/api/v1/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

Authorization

ApiKey

headerAuthorizationBearer <token>

Query Parameters

reportId?string

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

Length1 <= length <= 100

lifecycle?string

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

Value in"invited""in_progress""completed""expired""superseded"

externalReferenceSource?string

External source slug. Must be supplied with externalReferenceId.

Match^[a-z0-9]+(?:-[a-z0-9]+)*$

Length1 <= length <= 64

externalReferenceId?string

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

Length1 <= length <= 128

limit?integer

Page size, 1–100; defaults to 25.

Range1 <= value <= 100

Default25

cursor?string

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

Length1 <= length <= 2048

Response Body

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.

application/json

response

data*

# Set PROBB_URL and PROBB_API_KEY. Replace RESOURCE_ID if present.curl --fail-with-body -X GET "$PROBB_URL/api/v1/interviews" \  -H "Authorization: Bearer $PROBB_API_KEY"

{  "data": {    "items": [      {        "id": "interview_example",        "reportId": "report_example",        "interviewSystemVersion": "assigned-interview-version",        "createdAt": "2026-09-29T12:00:00.000Z",        "expiresAt": "2026-10-06T12:00:00.000Z",        "startedAt": null,        "completedAt": null,        "lifecycle": "invited",        "preparation": "queued",        "evaluation": "not_started",        "emailDelivery": "queued",        "resultRevision": null      }    ],    "nextCursor": null  }}