API

Our public API allows you to integrate blind hiring insights directly into your ATS, analytics tools, or hiring workflows. Use it to fetch interview data, scores, and decision signals — all anonymized and structured.

Authentication

All requests require a valid API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

GET /api/candidates/:id/insight

Fetch a structured AI insight summary for a specific candidate.

{
  "candidate_id": "abc123",
  "summary": "Strong communicator with concise technical framing...",
  "recommendation": "Recommended for second-round interview",
  "source": "notes",
  "generated_at": "2025-05-10T13:45:00Z"
}

POST /api/interview/:id/transcript

Submit a candidate message to append to a live interview transcript.

{
  "sender": "candidate",
  "message": "I’d describe my leadership style as empowering and data-driven..."
}

POST /api/redact/cv

Upload a candidate’s CV (PDF or DOCX) for redaction. The API returns a fully anonymized version and stores both original and redacted files securely.

Content-Type: multipart/form-data

Form Data:
- file: (CV file)

Response:
{
  "original_url": "https://storage.fairlane.ai/cvs/original_abc.pdf",
  "redacted_url": "https://storage.fairlane.ai/cvs/redacted_abc.pdf",
  "status": "complete"
}

POST /api/anonymize/audio

Submit a candidate’s audio introduction. This endpoint transcribes and anonymizes their voice using a synthetic narrator.

Content-Type: multipart/form-data

Form Data:
- file: (Audio file)

Response:
{
  "original_url": "https://storage.fairlane.ai/audio/original_abc.mp3",
  "anonymized_url": "https://storage.fairlane.ai/audio/anon_abc.mp3",
  "transcript": "Hi, I’m a backend developer who loves clean architecture.",
  "status": "processed"
}