Skip to main content
GET
/
api
/
v2
/
interviews
/
{interview_id}
/
data
Get full interview data
curl --request GET \
  --url https://api.heymilo.ai/api/v2/interviews/{interview_id}/data \
  --header 'X-API-KEY: <api-key>'
{
  "data": {
    "interview_id": "<string>",
    "posting_id": "<string>",
    "name": "<string>",
    "email": "<string>",
    "status": "<string>",
    "object": "interview_data",
    "candidate_id": "cand_def456",
    "score": 78.5,
    "workflow": {
      "steps": [
        {
          "step_id": "<string>",
          "order": 123,
          "status": "<string>",
          "started": true,
          "completed": true,
          "knocked_out": false,
          "last_updated_at": 1739713800
        }
      ],
      "all_complete": true,
      "last_activity_at": 1739715600
    },
    "web_interview": {
      "interview_id": "<string>",
      "match_score": 123,
      "object": "web_interview_result",
      "highlights": [
        "<string>"
      ],
      "lowlights": [
        "<string>"
      ],
      "scorecard": [
        {
          "question_id": "<string>",
          "question_text": "<string>",
          "score": 123,
          "evaluation_summary": "<string>",
          "evaluation_criteria": "<string>",
          "rank": 123,
          "score_weight": 5,
          "score_1_description": "Cannot articulate a basic design.",
          "score_5_description": "Comprehensive design with trade-off analysis.",
          "not_scored": false,
          "transcript": [
            {
              "speaker": "<string>",
              "text": "<string>",
              "timestamp": 123,
              "timestamp_str": "<string>"
            }
          ]
        }
      ],
      "speech_score": 3.5,
      "transcript": [
        {
          "speaker": "<string>",
          "text": "<string>",
          "timestamp": 123,
          "timestamp_str": "<string>"
        }
      ],
      "audio_recording_url": "https://cdn.heymilo.io/recordings/abc123.mp3",
      "video_recording_url": "https://cdn.heymilo.io/recordings/abc123.mp4",
      "tags": [
        "<string>"
      ]
    },
    "resume": {
      "interview_id": "<string>",
      "object": "resume_result",
      "overall_score": 78.5,
      "is_eligible": true,
      "score_criteria": [
        {
          "criteria_id": "<string>",
          "criteria_text": "<string>",
          "score": 123,
          "confidence": 123,
          "reasons": [
            "<string>"
          ]
        }
      ],
      "eligibility_criteria": [
        {
          "criteria_id": "<string>",
          "criteria_text": "<string>",
          "passed": true,
          "confidence": 123,
          "reasons": [
            "<string>"
          ]
        }
      ],
      "resume_url": "https://cdn.heymilo.io/resumes/abc123.pdf"
    },
    "sms": {
      "interview_id": "<string>",
      "is_eligible": true,
      "confidence": 123,
      "object": "sms_result",
      "criteria": [
        {
          "criteria_id": "<string>",
          "criteria_text": "<string>",
          "passed": true,
          "confidence": 123,
          "is_dealbreaker": false,
          "reasons": [
            "<string>"
          ]
        }
      ],
      "transcript": [
        {
          "role": "<string>",
          "text": "<string>",
          "timestamp": 1708012800
        }
      ],
      "messages_sent": 8,
      "messages_received": 6
    },
    "form": {
      "interview_id": "<string>",
      "overall_status": "<string>",
      "object": "form_result",
      "questions": [
        {
          "question_id": "<string>",
          "question_text": "<string>",
          "question_type": "<string>",
          "is_knockout": true,
          "passed": true,
          "candidate_answer": "yes",
          "expected_answer": "yes"
        }
      ]
    },
    "metadata": {
      "external_id": "interview_abc"
    },
    "data": {}
  },
  "meta": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.heymilo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-KEY
string
header
required

API key for authentication. Pass your key in the X-API-KEY header.

Headers

X-API-KEY
string
required

Path Parameters

interview_id
string
required

Response

Successful Response

data
InterviewDataResponse · object
required

Full interview results across all workflow steps.

Contains the candidate details plus per-agent results. Fields for agents not in the posting's workflow will be null.

meta
Meta · object

Optional metadata. Shape varies by endpoint.