List a dialer list's customers
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/dialer/lists/{id}/contacts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/dialer/lists/{id}/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/dialer/lists/{id}/contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "dlc_3f8a1c6b0d2e4f6a8b7c2e9a41b5d04f",
"list_id": "dl_7c2e9a41b5d04f3e8a1c6b0d2e4f6a8b",
"seq": 0,
"to": "+9198XXXXXX10",
"name": "Rahul Sharma",
"fields": {
"loan_id": "CF-LN-208841",
"amount_due": "4500"
},
"status": "done",
"attempts": 1,
"next_attempt_at": "2026-10-22T04:30:00.000Z",
"assigned_to": null,
"last_call_id": "call_5b8e1d2c3a4f4b6e9d7c8a1b2c3d4e5f",
"call_ids": [
"call_5b8e1d2c3a4f4b6e9d7c8a1b2c3d4e5f"
],
"last_result": "completed",
"disposition": "promise_to_pay",
"done_at": "2026-10-22T04:42:10.000Z",
"updated_at": "2026-10-22T04:42:10.000Z"
}
],
"next_cursor": null
}Power dialer
List a dialer list's customers
In upload order, optionally one status only; page with cursor (the next_cursor of the previous page).
GET
/
v1
/
dialer
/
lists
/
{id}
/
contacts
List a dialer list's customers
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/dialer/lists/{id}/contacts \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/dialer/lists/{id}/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/dialer/lists/{id}/contacts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "dlc_3f8a1c6b0d2e4f6a8b7c2e9a41b5d04f",
"list_id": "dl_7c2e9a41b5d04f3e8a1c6b0d2e4f6a8b",
"seq": 0,
"to": "+9198XXXXXX10",
"name": "Rahul Sharma",
"fields": {
"loan_id": "CF-LN-208841",
"amount_due": "4500"
},
"status": "done",
"attempts": 1,
"next_attempt_at": "2026-10-22T04:30:00.000Z",
"assigned_to": null,
"last_call_id": "call_5b8e1d2c3a4f4b6e9d7c8a1b2c3d4e5f",
"call_ids": [
"call_5b8e1d2c3a4f4b6e9d7c8a1b2c3d4e5f"
],
"last_result": "completed",
"disposition": "promise_to_pay",
"done_at": "2026-10-22T04:42:10.000Z",
"updated_at": "2026-10-22T04:42:10.000Z"
}
],
"next_cursor": null
}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
dl_ + 32 hex characters.
Query Parameters
Only this status: pending (to call, or waiting for a retry), in_progress (with an agent), done, exhausted (attempts used up), removed.
Available options:
pending, in_progress, done, exhausted, removed Page size, 1 to 200 (default 50).
Required range:
1 <= x <= 200The next_cursor of the previous page.
Required range:
x >= 0