---
title: "Get Interview Info"
method: GET
path: "/api/interview/join/{token}"
tags: ["interview-join"]
---

# Get Interview Info

`GET /api/interview/join/{token}`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/interview/join/{token}`
- Auth: none declared

Get interview details for candidate.

This is a PUBLIC endpoint - no authentication required.
Only returns non-sensitive information needed for the join page.

## Path parameters

- `token` string, required

## Response `200`

Successful Response

- InterviewJoinInfo: Public interview info for candidate (no sensitive data)
  - `interview_id` string, nullable
  - `candidate_first_name` string, required
  - `job_title` string, required
  - `company_name` string, required
  - `interview_type` string, nullable
  - `interviewer_type` string, nullable
  - `duration_minutes` integer
  - `status` string, required
  - `delivery_mode` string, nullable
  - `meeting_url` string, nullable
  - `meeting_token` string, nullable
  - `voice_provider` string, nullable
  - `competencies` string[]
  - `plan_ready` boolean
  - `has_coding_stage` boolean
  - `skill_problem` string, nullable
  - `plan_round` object, nullable
  - `skill_name` string, nullable
  - `is_campaign` boolean
  - `resume_mode` string, nullable
  - `branding` CandidateBranding: What the lobby may take from an org's branding. Filtered server-side; this endpoint is public.
    - `theme` object, nullable
    - `logo_url` string, nullable
  - `journey` CandidateJourneyInfo: Who owns what the candidate sees after the call (0003 §6b). Resolved from the org's setting (parent org for a sandbox) — see core.domains.org.candidate_journey. Always present; hiring is the default every org has today.
    - `mode` string
    - `presenter_name` string
    - `return_url` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)