List a candidate's interviews

{
  "data": [
    {
      "id": "int_6PzR3wLnUd",
      "candidate_id": "cand_5DkW9rTzPe",
      "external_ref": "cl_app_84321",
      "status": "scheduled",
      "start": "2024-01-15T09:30:00Z",
      "end": "2024-01-15T09:30:00Z",
      "timezone": "America/New_York",
      "interviewer": {
        "name": "string",
        "email": "string"
      },
      "location_or_link": "string",
      "booked_by": "agent",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

Returns a cursor-paginated list of the candidate’s interviews. Scheduling itself happens inside CONFIRM (the AI agent offers slots, the candidate self-books, or a recruiter books); partners consume bookings via webhooks and these read endpoints. Partner-side booking is not available in v1 (roadmap).

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_...).

cand_idstringRequired

Candidate ID (cand_...).

Query parameters

limitintegerOptional1-100Defaults to 20

Page size, 1–100.

cursorstringOptional

Opaque cursor from a previous response’s next_cursor.

Response

Paginated interview list.

datalist of objectsOptional

has_morebooleanOptional

next_cursorstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

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