curl --request GET \
--url https://api.voice.mergenlab.ai/v1/calls/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/calls/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/calls/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "call_9f1c2a7e4b3d4c0e8a6b5d2f1e0c9b8a",
"agent_id": "agt_credfin_dpd_8_30_m",
"call_type": "ai_voice",
"to": "+9198XXXXXX01",
"status": "completed",
"scheduled_for": null,
"attempts_count": 1,
"outcome": "promise_to_pay",
"summary": "The borrower confirmed the overdue amount of INR 4,574 and promised to pay in full by Friday.",
"duration_sec": 61.5,
"billable_minutes": 2,
"cost": {
"amount_micros": 9180000,
"currency": "INR",
"status": "final"
},
"has_recording": true,
"has_transcript": true,
"metadata": {
"loan_id": "CF-LN-208841",
"borrower_ref": "BR-55102"
},
"created_at": "2026-10-12T05:30:00.120Z",
"updated_at": "2026-10-12T05:37:42.906Z",
"ended_at": "2026-10-12T05:31:14.880Z",
"attempts": [
{
"id": "att_7b2e4c1d9a8f4e3b8c2d1a0f9e8d7c6b",
"attempt_number": 1,
"call_type": "ai_voice",
"status": "completed",
"failure_reason": null,
"ended_by": "user",
"duration_sec": 61.5,
"billable_minutes": 2,
"started_at": "2026-10-12T05:30:11.402Z",
"ended_at": "2026-10-12T05:31:14.880Z",
"outcome": "promise_to_pay",
"cost": {
"amount_micros": 9180000,
"currency": "INR",
"status": "final"
}
}
]
}Get a call with its attempts
One call with every dial attempt (attempts, oldest first): status, outcome, duration and cost. AI calls add
summary and final_variables; human calls a human block; reachability dials reachability; pre-recorded
campaign calls broadcast (with listened_sec). Another account’s or an unknown id is 404.
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/calls/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/calls/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/calls/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "call_9f1c2a7e4b3d4c0e8a6b5d2f1e0c9b8a",
"agent_id": "agt_credfin_dpd_8_30_m",
"call_type": "ai_voice",
"to": "+9198XXXXXX01",
"status": "completed",
"scheduled_for": null,
"attempts_count": 1,
"outcome": "promise_to_pay",
"summary": "The borrower confirmed the overdue amount of INR 4,574 and promised to pay in full by Friday.",
"duration_sec": 61.5,
"billable_minutes": 2,
"cost": {
"amount_micros": 9180000,
"currency": "INR",
"status": "final"
},
"has_recording": true,
"has_transcript": true,
"metadata": {
"loan_id": "CF-LN-208841",
"borrower_ref": "BR-55102"
},
"created_at": "2026-10-12T05:30:00.120Z",
"updated_at": "2026-10-12T05:37:42.906Z",
"ended_at": "2026-10-12T05:31:14.880Z",
"attempts": [
{
"id": "att_7b2e4c1d9a8f4e3b8c2d1a0f9e8d7c6b",
"attempt_number": 1,
"call_type": "ai_voice",
"status": "completed",
"failure_reason": null,
"ended_by": "user",
"duration_sec": 61.5,
"billable_minutes": 2,
"started_at": "2026-10-12T05:30:11.402Z",
"ended_at": "2026-10-12T05:31:14.880Z",
"outcome": "promise_to_pay",
"cost": {
"amount_micros": 9180000,
"currency": "INR",
"status": "final"
}
}
]
}Authorizations
Authorization: Bearer vg_live_<32 hex characters>. Keys are issued by Mergen admins and shown once.
Missing or invalid key: 401 unauthorized. Suspended account: 403 tenant_suspended.
Path Parameters
Call id (call_ + 32 hex characters).
Response
The call and its attempts in order.
A call with all its attempts (oldest first).
call_ + 32 hex characters.
"call_9f1c2a7e4b3d4c0e8a6b5d2f1e0c9b8a"
The voice agent; null for human calls, reachability dials and broadcast dials.
"agt_credfin_dpd_8_30_m"
ai_voice: a voice agent calls the customer. human: your agent and the customer bridged by phone.
reachability: one dial of a reachability check. broadcast: one dial of a voice broadcast.
ai_voice, human, reachability, broadcast Customer number, E.164.
"+9198XXXXXX01"
queued (waiting for its first dial, a scheduled time, the calling window or a retry), dialling (an attempt
is live), then terminal completed (a person was connected), no_answer, busy, failed, canceled.
An AI call goes back to queued while a retry is pending.
queued, dialling, completed, no_answer, busy, failed, canceled When a queued call will be dialled (a future schedule_at, the next calling window start, or the retry time). null when it is due now or the call is not queued.
Dial attempts made so far.
x >= 0AI calls: the outcome reported by the agent for the latest attempt (agent-specific, for example
promise_to_pay, no_commitment, callback_requested), null until analysed. Human calls: the terminal
human.status. Reachability and broadcast dials: the dial result.
"promise_to_pay"
Short summary of the conversation (AI calls), null otherwise or until analysed.
Seconds of the latest attempt: conversation length for AI calls, talk time (agent and customer bridged)
for human calls, seconds held after the answer for reachability dials, seconds from the answer to the
hangup for broadcast dials. null until known.
61.5
Billable minutes summed over the call's attempts (each connected attempt rounded up to whole minutes; 0 when not connected).
x >= 0Your cost summed over the call's attempts; pending while the call is not over or any attempt's cost is not final.
Show child attributes
Show child attributes
Always false for human calls, reachability dials and broadcast dials.
The metadata you sent (reachability dials carry the number's items_metadata, broadcast dials the broadcast's and the item's metadata), or null.
When the call reached a terminal status.
Show child attributes
Show child attributes
Only on AI calls, once dialled: the number the latest attempt dialled from (given at dial time from your
free numbers; see from on the request).
"+9180XXXXXX79"
When a call that is waiting for a free line is expected to start. An estimate; null once the call is placed.
Live state of a human call (human on CallView; only on human calls).
Show child attributes
Show child attributes
The check this dial belongs to (reachability dials only).
"rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f"
One dial of a reachability check (reachability on CallView; only on reachability calls). The call's
status for a ring-check dial: dialling while live, completed only when the customer picked up
(answered), no_answer for ringing (not answered) and switched_off, busy for busy, failed for
invalid and failed, canceled for canceled.
Show child attributes
Show child attributes
The voice broadcast this dial belongs to (broadcast dials only).
"vbc_7c1e9a3b5d2f4e6a8b0c2d4e6f8a1b3c"
One dial of a voice broadcast (broadcast on CallView; only on broadcast calls). The call's status:
dialling while live, completed for played and partial (a person heard the message; priced),
no_answer for voicemail and no_answer, busy, failed for failed and invalid, canceled.
Show child attributes
Show child attributes
Human calls only (absent on others); null until your agent sets one (PUT /v1/calls/{id}/disposition).
Show child attributes
Show child attributes
The campaign that placed this call (campaign calls only; GET /v1/calls?campaign_id=).
"cmp_3b9e1f7a2c4d4e6f8a0b1c2d3e4f5a6b"
The campaign record (rec_...) the call was for (campaign calls only).
"rec_1a2b3c4d5e6f40718293a4b5c6d7e8f9"
Which attempt of the record's ladder the call is, as attempt_<number> (campaign calls only).
"attempt_2"