curl --request GET \
--url https://api.voice.mergenlab.ai/v1/reachability-checks/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/reachability-checks/{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/reachability-checks/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f",
"status": "running",
"mode": "answer",
"from": "+9180XXXXXX79",
"hold_sec": 12,
"ring_sec": null,
"ring_timeout_sec": 45,
"machine_detection": true,
"answer_message": "नमस्ते, यह Credfin से कॉल है। हमारी टीम आपको जल्द ही कॉल करेगी।",
"max_attempts": 2,
"retry_delays_min": [
5
],
"created_at": "2026-10-12T05:20:00.012Z",
"updated_at": "2026-10-12T05:20:00.012Z",
"completed_at": null,
"canceled_at": null,
"counts": {
"total": 3,
"pending": 1,
"dialling": 0,
"reachable": 1,
"voicemail": 0,
"no_answer": 0,
"ringing": 0,
"switched_off": 0,
"busy": 0,
"failed": 0,
"invalid": 0,
"skipped": 1,
"canceled": 0
},
"cost": {
"amount_micros": 650000,
"currency": "INR",
"status": "pending"
},
"metadata": {
"campaign": "dpd-8-30-morning"
}
}Get a reachability check
The check with its counts and cost, computed at read time.
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/reachability-checks/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/reachability-checks/{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/reachability-checks/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f",
"status": "running",
"mode": "answer",
"from": "+9180XXXXXX79",
"hold_sec": 12,
"ring_sec": null,
"ring_timeout_sec": 45,
"machine_detection": true,
"answer_message": "नमस्ते, यह Credfin से कॉल है। हमारी टीम आपको जल्द ही कॉल करेगी।",
"max_attempts": 2,
"retry_delays_min": [
5
],
"created_at": "2026-10-12T05:20:00.012Z",
"updated_at": "2026-10-12T05:20:00.012Z",
"completed_at": null,
"canceled_at": null,
"counts": {
"total": 3,
"pending": 1,
"dialling": 0,
"reachable": 1,
"voicemail": 0,
"no_answer": 0,
"ringing": 0,
"switched_off": 0,
"busy": 0,
"failed": 0,
"invalid": 0,
"skipped": 1,
"canceled": 0
},
"cost": {
"amount_micros": 650000,
"currency": "INR",
"status": "pending"
},
"metadata": {
"campaign": "dpd-8-30-morning"
}
}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
Reachability check id (rch_ + 32 hex characters).
Response
The check.
rch_ + 32 hex characters.
"rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f"
running (dialling), waiting_window (outside your calling hours, numbers wait), queued (paused on our side,
for example reachability was disabled after creation), then completed or canceled.
queued, running, waiting_window, completed, canceled answer (default): wait for a pick-up, hold the line hold_sec seconds and hang up. ring: hang up as soon as
the phone has rung ring_sec seconds; nobody needs to pick up (the customer sees a missed call).
answer, ring Caller ID used, E.164.
null for a ring check.
null for an answer check.
false for a ring check.
null for a ring check.
When the batch finished (also set on a canceled check once its last dial ends).
Numbers per result (computed when read). total = numbers sent, duplicates and invalid inputs included.
Show child attributes
Show child attributes
Your cost (never the provider's). pending until every part of the cost is known, then final. no_rule:
no pricing is configured for your account yet (amount_micros is null). Integer INR micros
(1,000,000 = INR 1).
Show child attributes
Show child attributes
The metadata you sent; {} when none.
Only on a check a campaign placed (a ring_check step; lists show those with include_campaign=true); absent otherwise, as on a CallView. Also in the reachability.* webhooks.
The campaign contact (cct_...) the check was placed for; with campaign_id only.
The campaign step that placed it; with campaign_id only.