GET /interviews/{id} — Fetch Interview Session Data

Use GET /interviews/{interview_id} to fetch the current status and metadata of a specific interview session. This is useful for polling interview progress or confirming a session’s configuration before following up with a candidate. Endpoint

GET https://api.techeval.ai/v1/interviews/{interview_id}

Authentication: Bearer token required — see Authentication.

Path Parameters

string

required

The unique identifier of the interview session to retrieve (e.g., "int_a1b2c3d4"). This is the interview_id returned when you scheduled the interview.

Example Request

curl -X GET https://api.techeval.ai/v1/interviews/int_a1b2c3d4 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

A successful 200 OK response returns the following fields:

string

The unique identifier for this interview session.

string

The full name of the candidate as provided when the interview was scheduled.

string

The email address of the candidate.

string

The job role the candidate is being evaluated for.

string

The type of interview conducted (e.g., "System Design", "Technical Deep Dive").

string

The seniority level at which the candidate was evaluated (e.g., "Mid-Level to Senior").

string

The current state of the interview session. See Interview Status Values below.

string

The shareable URL for the candidate to access the interview. This URL respects the expires_at deadline.

string

ISO 8601 timestamp indicating when the interview link expires.

string

ISO 8601 timestamp indicating when the interview session was created.

Example response:

{
  "interview_id": "int_a1b2c3d4",
  "candidate_name": "Jane Smith",
  "candidate_email": "jane@example.com",
  "role": "AI Engineer",
  "interview_type": "System Design",
  "evaluation_level": "Mid-Level to Senior",
  "status": "completed",
  "interviewUrl": "https://techeval.ai/interview/int_a1b2c3d4",
  "expires_at": "2025-09-15T14:30:00Z",
  "created_at": "2025-09-12T14:30:00Z"
}

Interview Status Values

Status	Meaning
`scheduled`	The interview session has been created and the link is active, but the candidate has not yet started
`in_progress`	The candidate has opened the link and the interview is currently underway
`completed`	The candidate has finished the interview and a scorecard is available
`expired`	The interview link has passed its `expires_at` deadline without the candidate completing it

Overview

Interviews

Scorecards

GET /interviews/{id} — Fetch Interview Session Data

Path Parameters

Example Request

Response

Interview Status Values

​Path Parameters

​Example Request

​Response

​Interview Status Values

Path Parameters

Example Request

Response

Interview Status Values