Retrieve an interview | CONFIRM Docs

Retrieves a single interview. Partner-side booking and rescheduling are not available in v1 (roadmap); consume changes via the interview.* webhooks.

Authentication

AuthorizationBearer

Partner API key sent as Authorization: Bearer cfk_.... Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Path parameters

org_idstringRequired

Organization ID (org_...).

int_idstringRequired

Interview ID (int_...).

Response

The interview.

idstringOptional

Interview ID (int_...).

candidate_idstringOptional

external_refstring or nullOptional

The candidate’s external_ref, echoed for correlation.

statusenumOptional

startdatetimeOptional

Interview start (ISO 8601, with offset).

enddatetimeOptional

Interview end (ISO 8601, with offset).

timezonestringOptional

IANA timezone the interview was booked in.

interviewerobjectOptional

location_or_linkstringOptional

Physical address or video-call link.

booked_byenumOptional

Who booked the slot.

created_atdatetimeOptional

updated_atdatetimeOptional

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

1	{
2	"id": "int_6PzR3wLnUd",
3	"candidate_id": "cand_5DkW9rTzPe",
4	"external_ref": "cl_app_84321",
5	"status": "scheduled",
6	"start": "2024-01-15T09:30:00Z",
7	"end": "2024-01-15T09:30:00Z",
8	"timezone": "America/New_York",
9	"interviewer": {
10	"name": "string",
11	"email": "string"
12	},
13	"location_or_link": "string",
14	"booked_by": "agent",
15	"created_at": "2024-01-15T09:30:00Z",
16	"updated_at": "2024-01-15T09:30:00Z"
17	}

$	curl https://api.confirm.global/partner/v1/organizations/org_4Nv8sJqKfH/interviews/int_6PzR3wLnUd \
>	-H "Authorization: Bearer <token>"