Get an interview

GET

/api/v1/interviews/{id}

Read the independent candidate, preparation, evaluation, and email states of an interview attempt. Use this as the current attempt overview.

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" \  -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  }}