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"
        }
      ]
    },
    "cheat_detection": {
      "object": "cheat_detection",
      "overall_confidence": 0.64,
      "overall_ranking": 2,
      "enabled": true,
      "threshold": 70,
      "types": [
        "tab_switching",
        "ai_scripted_answer"
      ],
      "web_interview": {
        "cheat_detection_result": {
          "cheating_detected": true,
          "cheating_confidence": 123,
          "cheating_instances": [
            {
              "reasoning": "<string>",
              "transcript_references": [
                {
                  "user_friendly_timestamp": "<string>",
                  "text": "<string>",
                  "actual_timestamp": 123
                }
              ]
            }
          ]
        },
        "llm_detection_result": {
          "llm_generated_detected": true,
          "detection_confidence": 123,
          "llm_detected_segments": [
            {
              "segment_text": "<string>",
              "segment_confidence": 123,
              "reasoning": "<string>"
            }
          ],
          "gptzero_metrics": {
            "completely_generated_probability": 123,
            "overall_ai_score": 123,
            "average_generated_probability": 123
          }
        },
        "unusual_delay_detection": {
          "delay_detected": true,
          "delay_confidence": 123,
          "overall_score": 123,
          "confidence_level": 123,
          "unusual_delay_instances": [
            {}
          ]
        },
        "tab_switch_detection": {
          "first_switch_timestamp": 42,
          "total_count": 3
        },
        "interview_integrity": {
          "job_id": "<string>",
          "status": "completed",
          "filename": "<string>",
          "file_type": "video/mp4",
          "created_at": "<string>",
          "updated_at": "<string>",
          "result": {},
          "error": "<string>",
          "comprehensive": {},
          "aggregated": {
            "movements": [
              {
                "type": "<string>",
                "confidence": 0.8,
                "image": "<string>",
                "timestamp": 91
              }
            ]
          }
        },
        "integrity_analysis_v2": {}
      },
      "resume": {
        "gpt_detection": {
          "version": "<string>",
          "scanId": "<string>",
          "documents": [
            {}
          ],
          "neatVersion": "<string>",
          "editorDocumentId": "<string>"
        }
      }
    },
    "metadata": {
      "external_id": "interview_abc"
    },
    "data": {}
  },
  "meta": {}
}

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 | null
Authorization
string | null
X-Workspace-Id
string | null

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 | null

Optional metadata. Shape varies by endpoint.