Get interview status

GET

/api/v1/interviews/{id}/status

Read the independent candidate, preparation, evaluation, and email states of an interview attempt. Use this endpoint to poll after an invitation or reconcile webhook events.

Before you call

Use the interviewId returned by invitation or List interviews, not the reportId.

Required scope: interviews:read.

What happens next

lifecycle tracks the candidate. preparation=ready means questions are prepared. evaluation=ready means the evaluation is available. emailDelivery=sent means provider acceptance, not inbox delivery.

Recovery

Fetch the result only when evaluation is ready. A preparation or delivery failure can occur while lifecycle remains invited. An expired or superseded invitation cannot start a new session.

Follow the complete workflow · Errors and retries

Authorization

ApiKey

headerAuthorizationBearer <token>

Path Parameters

id*string

Resource ID returned by this resource's creation or list endpoint. See prerequisites for whether this is a report, interview, job, or batch ID.

Length1 <= length <= 100

Response Body

lifecycle tracks the candidate. preparation=ready means questions are prepared. evaluation=ready means the evaluation is available. emailDelivery=sent means provider acceptance, not inbox delivery.

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/RESOURCE_ID/status" \  -H "Authorization: Bearer $PROBB_API_KEY"

{  "data": {    "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  }}