AI Interviews at Scale

# 1. Create an API key (one-time via dashboard)
# 2. Schedule an interview

curl -X POST https://hirebox.in/api/v1/interviews \
  -H "X-API-Key: hb_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "candidate_email": "john@example.com",
    "candidate_name": "John Doe",
    "role": "Senior Backend Engineer",
    "experience_years": 5,
    "duration_minutes": 30,
    "send_results_to_candidate": false,
    "send_results_to_initiator": true
  }'

# Response (candidate receives interview link via email automatically):
# {
#   "interview_id": 42,
#   "session_id": "abc-123-...",
#   "status": "scheduled",
#   "magic_link": "https://hirebox.in/auth/magic/...",
#   "credits_remaining": 70
# }

# 3. Results are emailed to initiator automatically after interview
#    You can also check via API:
curl https://hirebox.in/api/v1/interviews/42 \
  -H "X-API-Key: hb_live_your_key_here"

import requests

API_KEY = "hb_live_your_key_here"
BASE = "https://hirebox.in/api/v1"
headers = {"X-API-Key": API_KEY}

# Schedule an interview
resp = requests.post(
    f"{BASE}/interviews",
    headers=headers,
    json={
        "candidate_email": "john@example.com",
        "candidate_name": "John Doe",
        "role": "Senior Backend Engineer",
        "experience_years": 5,
        "duration_minutes": 30,
        "send_results_to_candidate": False,
        "send_results_to_initiator": True,
    },
)
interview = resp.json()
# Candidate receives interview link via email automatically
print(f"Scheduled: {interview['interview_id']}")
print(f"Magic link: {interview['magic_link']}")
print(f"Credits left: {interview['credits_remaining']}")

# Results are emailed to initiator automatically
# You can also check via API:
result = requests.get(
    f"{BASE}/interviews/{interview['interview_id']}",
    headers=headers,
).json()

if result["status"] == "completed":
    ev = result["evaluation"]
    print(f"Score: {ev['technical_accuracy_score']}/10")
    print(f"Recommendation: {ev['recommendation']}")