Retrieves detailed information about a specific interview, including current status, candidate information, assessment results, and real-time analytics.
Path Parameters Unique interview identifier (e.g., int_abc123def456)
Query Parameters Include detailed assessment results and analytics in the response
Include interview transcript (only available for completed interviews)
Include recording URLs (requires appropriate permissions)
Response Unique interview identifier
Current interview status: scheduled, in_progress, completed, cancelled
Candidate information Candidate’s email address
Candidate’s full name (if provided)
ISO 8601 timestamp when candidate joined the interview
Job position for the interview
Array of skills being assessed
Interview difficulty level
Duration information Originally estimated duration
Actual duration (for completed interviews)
Schedule information ISO 8601 timestamp when interview was scheduled
ISO 8601 timestamp when interview started
ISO 8601 timestamp when interview completed
Assessment results (when include_results=true) Overall interview score (0-100)
Technical skills score (0-100)
Communication skills score (0-100)
Individual skill assessment scores
Identified candidate strengths
Areas needing improvement
AI recommendation: hire, maybe, no_hire
Real-time analytics data Candidate engagement: high, medium, low
Average response time metrics
question_difficulty_progression
How question difficulty adapted during interview
Related URLs Direct URL for candidate to join interview
Interviewer dashboard URL
Results page URL (for completed interviews)
Examples cURL
cURL with Results
JavaScript
Python
curl -X GET "https://backend.jobhive.ai/v1/interviews/int_abc123def456" \ -H "Authorization: Bearer YOUR_API_KEY"
Basic Response
Response with Results
{ "success" : true , "data" : { "id" : "int_abc123def456" , "status" : "completed" , "candidate" : { "email" : "[email protected] " , "name" : "John Doe" , "joined_at" : "2024-01-15T15:32:00Z" }, "position" : "Full Stack Developer" , "skills" : [ "JavaScript" , "React" , "Node.js" , "PostgreSQL" ], "difficulty" : "intermediate" , "duration" : { "estimated_minutes" : 45 , "actual_minutes" : 42 }, "schedule" : { "scheduled_at" : "2024-01-15T15:30:00Z" , "started_at" : "2024-01-15T15:32:00Z" , "completed_at" : "2024-01-15T16:14:00Z" }, "urls" : { "interview_url" : "https://app.jobhive.ai/interview/int_abc123def456" , "dashboard_url" : "https://app.jobhive.ai/dashboard/interview/int_abc123def456" , "results_url" : "https://app.jobhive.ai/results/int_abc123def456" }, "created_at" : "2024-01-15T14:30:00Z" , "updated_at" : "2024-01-15T16:14:00Z" } }
Error Responses Interview Not Found
Insufficient Permissions
{ "success" : false , "error" : { "code" : "INTERVIEW_NOT_FOUND" , "message" : "Interview with ID 'int_invalid123' not found" } }
Interview results and transcripts are only available for completed interviews. Recordings require special permissions and may incur additional charges.
