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": {}
}Retrieve the full interview results across all workflow steps. Includes per-agent results (scorecard, transcript, resume evaluation, SMS screening, form results). Returns status ‘not_ready’ if the candidate has not finished.
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.
API key for authentication. Pass your key in the X-API-KEY header.
Successful Response
Was this page helpful?