List calls

curl --request GET \
  --url https://api.voice.mergenlab.ai/v1/calls \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.voice.mergenlab.ai/v1/calls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "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"
    },
    {
      "id": "call_8c3e5a7b9d1f4e2a8b6c4d2e0f1a3b5c",
      "agent_id": null,
      "call_type": "reachability",
      "to": "+9198XXXXXX02",
      "status": "no_answer",
      "scheduled_for": null,
      "attempts_count": 1,
      "outcome": "no_answer",
      "summary": null,
      "duration_sec": null,
      "billable_minutes": 0,
      "cost": {
        "amount_micros": 0,
        "currency": "INR",
        "status": "final"
      },
      "has_recording": false,
      "has_transcript": false,
      "metadata": {
        "loan_id": "CF-LN-311907"
      },
      "created_at": "2026-10-12T05:20:04.311Z",
      "updated_at": "2026-10-12T05:20:30.018Z",
      "ended_at": "2026-10-12T05:20:30.018Z",
      "reachability_check_id": "rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f",
      "reachability": {
        "check_id": "rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f",
        "mode": "answer",
        "from": "+9180XXXXXX79",
        "hold_sec": 12,
        "ring_sec": null,
        "result": "no_answer",
        "amd_result": null,
        "answered_at": null,
        "rang_at": "2026-10-12T05:20:06.120Z",
        "answered": false,
        "detail": null,
        "talk_sec": null,
        "hangup_cause": "NO_ANSWER"
      }
    }
  ],
  "next_cursor": "eyJjIjoiMjAyNi0xMC0xMlQwNToyMDowNC4zMTFaIiwiaSI6ImNhbGxfOGMzZTVhN2I5ZDFmNGUyYThiNmM0ZDJlMGYxYTNiNWMifQ"
}

GET

calls

List calls

curl --request GET \
  --url https://api.voice.mergenlab.ai/v1/calls \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.voice.mergenlab.ai/v1/calls', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "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"
    },
    {
      "id": "call_8c3e5a7b9d1f4e2a8b6c4d2e0f1a3b5c",
      "agent_id": null,
      "call_type": "reachability",
      "to": "+9198XXXXXX02",
      "status": "no_answer",
      "scheduled_for": null,
      "attempts_count": 1,
      "outcome": "no_answer",
      "summary": null,
      "duration_sec": null,
      "billable_minutes": 0,
      "cost": {
        "amount_micros": 0,
        "currency": "INR",
        "status": "final"
      },
      "has_recording": false,
      "has_transcript": false,
      "metadata": {
        "loan_id": "CF-LN-311907"
      },
      "created_at": "2026-10-12T05:20:04.311Z",
      "updated_at": "2026-10-12T05:20:30.018Z",
      "ended_at": "2026-10-12T05:20:30.018Z",
      "reachability_check_id": "rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f",
      "reachability": {
        "check_id": "rch_4e7b1c9d2a3f4e5b8c6d7a8b9c0d1e2f",
        "mode": "answer",
        "from": "+9180XXXXXX79",
        "hold_sec": 12,
        "ring_sec": null,
        "result": "no_answer",
        "amd_result": null,
        "answered_at": null,
        "rang_at": "2026-10-12T05:20:06.120Z",
        "answered": false,
        "detail": null,
        "talk_sec": null,
        "hangup_cause": "NO_ANSWER"
      }
    }
  ],
  "next_cursor": "eyJjIjoiMjAyNi0xMC0xMlQwNToyMDowNC4zMTFaIiwiaSI6ImNhbGxfOGMzZTVhN2I5ZDFmNGUyYThiNmM0ZDJlMGYxYTNiNWMifQ"
}

Authorizations

Authorization

string

header

required

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.

Query Parameters

status

enum<string>

Only calls with this status. 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.

Available options:

queued,

dialling,

completed,

no_answer,

busy,

failed,

canceled

agent_id

string

Only calls of this agent.

Minimum string length: 1

string

Only calls to this customer number (any accepted Indian format; normalized before matching).

Minimum string length: 1

created_from

string<date-time>

Only items created at or after this instant (ISO 8601 with Z or an offset).

created_until

string<date-time>

Only items created at or before this instant (ISO 8601 with Z or an offset).

call_type

enum<string>

Only calls of this type. 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.

Available options:

ai_voice,

human,

reachability,

broadcast

agent_channel

enum<string>

Only human calls whose agent took the call this way: phone (rung on agent_phone) or web (in a browser, web calling).

Available options:

phone,

web

reachability_check_id

string

Only the dials of this reachability check.

Required string length: 1 - 128

broadcast_id

string

Only the dials of this voice broadcast (call_type broadcast).

Required string length: 1 - 128

campaign_id

string

Only the calls a campaign placed (any call type).

Required string length: 1 - 128

limit

integer

default:50

Page size.

Required range: 1 <= x <= 100

cursor

string

next_cursor of the previous page.

Minimum string length: 1

Response

A page of calls.

data

object[]

required

Show child attributes

next_cursor

string | null

required

Pass as cursor for the next page; null on the last page.

Calls

Reachability and missed calls

Campaigns

Payments and do-not-call

Power dialer

Web sessions

Account

Webhooks

List calls

Authorizations

Query Parameters

Response