List Calls

GET

calls

List Calls

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

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

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/v1/calls",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/v1/calls"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/v1/calls")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "call_abc123",
    "agent_id": "agent_2g7Xy3tY53gRlp",
    "to_number": "+919876543210",
    "duration": 42,
    "status": "initiated",
    "end_reason": "completed"
  }
]

{
  "statusCode": 400,
  "message": "Invalid query parameters",
  "error": "Bad Request"
}

{
  "statusCode": 401,
  "message": "API key is missing or invalid",
  "error": "Unauthorized"
}

{
  "statusCode": 403,
  "message": "Destination country or network prefix is not enabled for this workspace",
  "error": "Forbidden"
}

{
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Internal Server Error"
}

Read only Returns every call placed in your workspace, paginated and sorted by start time (newest first). Each entry includes the call’s id, current status, agent_id, destination phone number, duration, and creation timestamp. Use this endpoint for lightweight call browsing, status polling against a known set of recent calls, and quick filtering by agent, call id, batch call id, outcome, or time range. ID filters support comma-separated multi-value input. For the transcript, recording URL, sentiment, and structured post-call analysis of one result, use Get Call Details. The list endpoint is the lightweight view for browsing and filtering many calls.

When to use this

Operational dashboards: render a recent-calls table without paying the cost of full transcripts.
Live monitoring: quickly filter to initiated and in-progress calls to see active conversations.
Per-agent health checks: filter by agent_id to spot agents producing unusually high failure rates.
Batch exports: pass batch_call_id with export=true to download a combined CSV for one or more batches.

Query parameters

Parameter	Type	Description
`agent_id`	string	Filter by one agent ID or a comma-separated list of agent IDs.
`call_id`	string	Filter by one call ID or a comma-separated list of call IDs. `call_` prefixes are accepted.
`batch_call_id`	string	Filter by one batch call ID or a comma-separated list of batch call IDs. `batch_` and `campaign_` prefixes are accepted. Combine with `export=true` for a merged CSV across multiple batches.
`from`	string	Filter by sender phone number.
`to`	string	Filter by recipient phone number.
`type`	string	Filter by one call type or a comma-separated list of call types.
`call_direction`	string	Filter by one call direction or a comma-separated list of call directions.
`latency_min` / `latency_max`	number	Filter by minimum or maximum latency in milliseconds.
`agent_version_id`	string	Filter by one agent version ID or a comma-separated list of agent version IDs.
`agent_version_name`	string	Search by agent version name using a case-insensitive partial match.
`sentiment`	string	Filter by one sentiment or a comma-separated list, such as `positive,negative`.
`start_date`	string	Return only calls created on or after this ISO 8601 timestamp.
`end_date`	string	Return only calls created on or before this ISO 8601 timestamp.
`duration_greater_than` / `duration_less_than`	number	Filter by minimum or maximum call duration in milliseconds.
`duration_min` / `duration_max`	number	Filter by a duration range in milliseconds.
`page`	string	Page number, starting from 1. Send decimal digits.
`limit`	string	Results per page. Send decimal digits. Minimum: `1`. Default: `20`. Maximum: `200`.
`created_at`	string	Sort by creation date. Values: `asc`, `desc`.
`duration`	string	Sort by call duration. Values: `asc`, `desc`.
`status`	string	Filter by one call status or a comma-separated list, such as `completed,failed`.
`export`	boolean	Set to `true` to return matching rows as a flat list, bypassing pagination up to the applicable export limit. Use with `batch_call_id` or `call_id` for combined CSV exports.
`end_reason`	string	Filter by one exact hang up reason or a comma-separated list of `end_reason` values.
`columns`	string	Export only. Comma-separated column keys. Excluding both `transcript` and `summary` raises the single-export limit from `5,000` to `10,000` rows. Omit this parameter to include all columns.

Exports that include transcript or summary are limited to 5,000 matching calls. Exports that request neither heavy column are limited to 10,000. A request over the applicable limit returns 400 Bad Request with the matched row count and guidance to narrow the date range or add filters.

Filter IVR Calls And Lead Tags

is_ivr=true selects IVR calls, including conversational handoffs. Use false for non-IVR calls or omit it for all calls.
tags=priority,september selects workflow lead tags copied to call records when calls were placed.
tags_match=any matches at least one tag and is the default. Use tags_match=all to require every selected tag. Tags are normalized to lowercase.

These read-only filters can be combined with a date range and retried safely.

Errors

400 Bad Request is returned when one or more query parameters are invalid or an export exceeds the applicable row limit.
401 Unauthorized is returned when the API key is missing or invalid.
403 Forbidden is returned when the API key does not have access to this organization.
500 Internal Server Error is returned on an unexpected server-side failure.

Get Call Details: fetch a single call’s detail.
Trigger a Call: start a new outbound call.
API pagination: how DialNexa list endpoints paginate.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

agent_id

string

Filter by agent ID(s) - can be a single ID or comma-separated list (e.g., 1,2,3)

call_id

string

Filter by call ID - can be a single ID or comma-separated list (e.g., call_abc,call_def)

batch_call_id

string

Filter by batch call ID - can be a single ID or comma-separated list (e.g., batch_abc,batch_def)

from

string

Filter by sender phone number

string

Filter by recipient phone number

type

enum<string>

Filter by call type(s) - can be a single value or comma-separated list

Available options:

phone,

web

call_direction

enum<string>

Filter by call direction(s) - can be a single value or comma-separated list

Available options:

inbound,

outbound

latency_min

number

Filter by minimum latency (in milliseconds)

latency_max

number

Filter by maximum latency (in milliseconds)

agent_version_id

string

Filter by agent version ID(s) - can be a single ID or comma-separated list (e.g., 1,2,3)

agent_version_name

string

Search by agent version name (partial match, case-insensitive)

sentiment

enum<string>

Filter by sentiment(s) - can be a single value or comma-separated list

Available options:

positive,

neutral,

negative,

unknown

start_date

string

Filter by start date (ISO format)

end_date

string

Filter by end date (ISO format)

duration_greater_than

number

Filter by minimum call duration (in milliseconds)

duration_less_than

number

Filter by maximum call duration (in milliseconds)

duration_min

number

Filter by minimum duration range (in milliseconds)

duration_max

number

Filter by maximum duration range (in milliseconds)

page

string

Page number (starts from 1)

limit

string

Number of records per page (min: 1, default: 20, max: 200)

created_at

enum<string>

Sort by created_at (asc or desc)

Available options:

asc,

desc

duration

enum<string>

Sort by duration (asc or desc)

Available options:

asc,

desc

status

string

Filter by call status(es) - can be a single status or comma-separated list

export

boolean

Set to true to export all data without pagination

end_reason

string

Filter by end/hangup reason - exact match; comma-separate multiple values for OR filtering

columns

string

Export only: comma-separated column keys. Omitting both transcript and summary raises the single-export limit from 5000 to 10000 rows. Omit this parameter to include all columns.

Example:

"duration,status,agent_name"

is_ivr

boolean

True for IVR calls including handoffs, false for other calls; omit for all.

Response

Calls returned successfully.

string

required

Signed call ID

Example:

"call_abc123"

List Calls

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

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

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/v1/calls",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/v1/calls"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/v1/calls")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "call_abc123",
    "agent_id": "agent_2g7Xy3tY53gRlp",
    "to_number": "+919876543210",
    "duration": 42,
    "status": "initiated",
    "end_reason": "completed"
  }
]

{
  "statusCode": 400,
  "message": "Invalid query parameters",
  "error": "Bad Request"
}

{
  "statusCode": 401,
  "message": "API key is missing or invalid",
  "error": "Unauthorized"
}

{
  "statusCode": 403,
  "message": "Destination country or network prefix is not enabled for this workspace",
  "error": "Forbidden"
}

{
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Internal Server Error"
}

Overview

Endpoints

When to use this

Query parameters

Filter IVR Calls And Lead Tags

Errors

Authorizations

Query Parameters

Response

​When to use this

​Query parameters

​Filter IVR Calls And Lead Tags

​Errors

​Related endpoints

Authorizations

Query Parameters

Response

When to use this

Query parameters

Filter IVR Calls And Lead Tags

Errors

Related endpoints