List the records of a campaign
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/campaigns/{campaignId}/records \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/campaigns/{campaignId}/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/campaigns/{campaignId}/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "rec_1a2b3c4d5e6f40718293a4b5c6d7e8f9",
"campaign_id": "cmp_7c1d2e3f4a5b4c6d8e9f0a1b2c3d4e5f",
"seq": 1,
"phone": "+9198XXXXXX01",
"external_id": "LN-123",
"variables": {
"borrower_first_name": "Ravi",
"emi_amount": "4574",
"due_date": "2026-11-05",
"lender_name": "Credfin"
},
"source": "csv",
"source_row": 2,
"status": "completed",
"result": "success",
"result_detail": "confirmed_on_time",
"missing_variables": [],
"attempts_made": 2,
"callbacks_used": 0,
"next_attempt_number": null,
"next_attempt_at": null,
"next_is_callback": false,
"last_status": "completed",
"last_outcome": "confirmed_on_time",
"last_call_at": "2026-10-26T10:31:00.000Z",
"post_call": {
"payment_date": "2026-11-05"
},
"attempts": [
{
"attempt_number": 1,
"call_id": "call_0a1b2c3d4e5f40718293a4b5c6d7e8f1",
"scheduled_for": "2026-10-26T04:30:00.000Z",
"started_at": "2026-10-26T04:30:04.000Z",
"ended_at": "2026-10-26T04:30:49.000Z",
"status": "no_answer",
"outcome": null,
"duration_sec": 0,
"post_call": {},
"cost_micros": 0,
"decision": "instant_redial",
"callback": false
},
{
"attempt_number": 2,
"call_id": "call_0a1b2c3d4e5f40718293a4b5c6d7e8f2",
"scheduled_for": "2026-10-26T10:30:00.000Z",
"started_at": "2026-10-26T10:30:02.000Z",
"ended_at": "2026-10-26T10:31:00.000Z",
"status": "completed",
"outcome": "confirmed_on_time",
"duration_sec": 52,
"post_call": {
"payment_date": "2026-11-05"
},
"cost_micros": 4500000,
"decision": "done",
"callback": false
}
],
"paid_at": null,
"collected_micros": 0,
"closed_at": "2026-10-26T10:31:00.000Z",
"created_at": "2026-10-24T05:05:00.000Z",
"updated_at": "2026-10-26T10:31:00.000Z"
},
{
"id": "rec_2b3c4d5e6f7a40718293a4b5c6d7e8f9",
"campaign_id": "cmp_7c1d2e3f4a5b4c6d8e9f0a1b2c3d4e5f",
"seq": 2,
"phone": "+9198XXXXXX02",
"external_id": "LN-124",
"variables": {
"borrower_first_name": "Sunita",
"emi_amount": "3400",
"due_date": "2026-11-05",
"lender_name": "Credfin"
},
"source": "csv",
"source_row": 3,
"status": "pending",
"result": null,
"result_detail": null,
"missing_variables": [],
"attempts_made": 1,
"callbacks_used": 0,
"next_attempt_number": 2,
"next_attempt_at": "2026-10-26T10:30:00.000Z",
"next_is_callback": false,
"last_status": "busy",
"last_outcome": null,
"last_call_at": "2026-10-26T04:31:00.000Z",
"post_call": {},
"attempts": [
{
"attempt_number": 1,
"call_id": "call_0a1b2c3d4e5f40718293a4b5c6d7e8f3",
"scheduled_for": "2026-10-26T04:30:00.000Z",
"started_at": "2026-10-26T04:30:40.000Z",
"ended_at": "2026-10-26T04:31:00.000Z",
"status": "busy",
"outcome": null,
"duration_sec": 0,
"post_call": {},
"cost_micros": 0,
"decision": "retry",
"callback": false
}
],
"paid_at": null,
"collected_micros": 0,
"closed_at": null,
"created_at": "2026-10-24T05:05:00.000Z",
"updated_at": "2026-10-26T04:31:00.000Z"
}
],
"next_cursor": "eyJzZXEiOjJ9"
}Campaigns
List the records of a campaign
The campaign’s records in the order they arrived, each with its status, result, resolved variables and every attempt so far.
GET
/
v1
/
campaigns
/
{campaignId}
/
records
List the records of a campaign
curl --request GET \
--url https://api.voice.mergenlab.ai/v1/campaigns/{campaignId}/records \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.voice.mergenlab.ai/v1/campaigns/{campaignId}/records', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.voice.mergenlab.ai/v1/campaigns/{campaignId}/records"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "rec_1a2b3c4d5e6f40718293a4b5c6d7e8f9",
"campaign_id": "cmp_7c1d2e3f4a5b4c6d8e9f0a1b2c3d4e5f",
"seq": 1,
"phone": "+9198XXXXXX01",
"external_id": "LN-123",
"variables": {
"borrower_first_name": "Ravi",
"emi_amount": "4574",
"due_date": "2026-11-05",
"lender_name": "Credfin"
},
"source": "csv",
"source_row": 2,
"status": "completed",
"result": "success",
"result_detail": "confirmed_on_time",
"missing_variables": [],
"attempts_made": 2,
"callbacks_used": 0,
"next_attempt_number": null,
"next_attempt_at": null,
"next_is_callback": false,
"last_status": "completed",
"last_outcome": "confirmed_on_time",
"last_call_at": "2026-10-26T10:31:00.000Z",
"post_call": {
"payment_date": "2026-11-05"
},
"attempts": [
{
"attempt_number": 1,
"call_id": "call_0a1b2c3d4e5f40718293a4b5c6d7e8f1",
"scheduled_for": "2026-10-26T04:30:00.000Z",
"started_at": "2026-10-26T04:30:04.000Z",
"ended_at": "2026-10-26T04:30:49.000Z",
"status": "no_answer",
"outcome": null,
"duration_sec": 0,
"post_call": {},
"cost_micros": 0,
"decision": "instant_redial",
"callback": false
},
{
"attempt_number": 2,
"call_id": "call_0a1b2c3d4e5f40718293a4b5c6d7e8f2",
"scheduled_for": "2026-10-26T10:30:00.000Z",
"started_at": "2026-10-26T10:30:02.000Z",
"ended_at": "2026-10-26T10:31:00.000Z",
"status": "completed",
"outcome": "confirmed_on_time",
"duration_sec": 52,
"post_call": {
"payment_date": "2026-11-05"
},
"cost_micros": 4500000,
"decision": "done",
"callback": false
}
],
"paid_at": null,
"collected_micros": 0,
"closed_at": "2026-10-26T10:31:00.000Z",
"created_at": "2026-10-24T05:05:00.000Z",
"updated_at": "2026-10-26T10:31:00.000Z"
},
{
"id": "rec_2b3c4d5e6f7a40718293a4b5c6d7e8f9",
"campaign_id": "cmp_7c1d2e3f4a5b4c6d8e9f0a1b2c3d4e5f",
"seq": 2,
"phone": "+9198XXXXXX02",
"external_id": "LN-124",
"variables": {
"borrower_first_name": "Sunita",
"emi_amount": "3400",
"due_date": "2026-11-05",
"lender_name": "Credfin"
},
"source": "csv",
"source_row": 3,
"status": "pending",
"result": null,
"result_detail": null,
"missing_variables": [],
"attempts_made": 1,
"callbacks_used": 0,
"next_attempt_number": 2,
"next_attempt_at": "2026-10-26T10:30:00.000Z",
"next_is_callback": false,
"last_status": "busy",
"last_outcome": null,
"last_call_at": "2026-10-26T04:31:00.000Z",
"post_call": {},
"attempts": [
{
"attempt_number": 1,
"call_id": "call_0a1b2c3d4e5f40718293a4b5c6d7e8f3",
"scheduled_for": "2026-10-26T04:30:00.000Z",
"started_at": "2026-10-26T04:30:40.000Z",
"ended_at": "2026-10-26T04:31:00.000Z",
"status": "busy",
"outcome": null,
"duration_sec": 0,
"post_call": {},
"cost_micros": 0,
"decision": "retry",
"callback": false
}
],
"paid_at": null,
"collected_micros": 0,
"closed_at": null,
"created_at": "2026-10-24T05:05:00.000Z",
"updated_at": "2026-10-26T04:31:00.000Z"
}
],
"next_cursor": "eyJzZXEiOjJ9"
}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
Campaign id (cmp_ + 32 hex characters).
Query Parameters
Only records with this status.
pending (waiting for its next attempt), calling (an attempt is on the line), completed (finished with a
success, another final outcome or a wrong number), exhausted (attempts or the schedule used up), closed
(do not call, paid, or canceled) and skipped (never called: invalid phone, duplicate or missing variables).
Available options:
pending, calling, completed, exhausted, closed, skipped Only records with this result.
How a record ended: success (an outcome of goal.outcomes), wrong_number, final_outcome (another outcome
that ends the record; result_detail names it), exhausted (no attempt left), end_date (the schedule ended
first), do_not_call, paid (a customer event), canceled, invalid_phone, duplicate and
missing_variables (result_detail lists them).
Available options:
success, wrong_number, final_outcome, exhausted, end_date, do_not_call, paid, canceled, invalid_phone, duplicate, missing_variables Part of a phone number or an external_id.
Required string length:
1 - 100Page size.
Required range:
1 <= x <= 500next_cursor of the previous page.
Minimum string length:
1