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",
    "from_number": "+14155552671",
    "status": "initiated",
    "call_direction": "outbound",
    "createdAt": "2026-07-03T10:30:00.000Z",
    "duration": 42,
    "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 all matching rows as a flat list, bypassing pagination. 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.

Errors

400 Bad Request is returned when one or more query parameters are invalid.
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.
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

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",
    "from_number": "+14155552671",
    "status": "initiated",
    "call_direction": "outbound",
    "createdAt": "2026-07-03T10:30:00.000Z",
    "duration": 42,
    "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

Code Examples And SDK Status

When to use this

Query parameters

Errors

Authorizations

Query Parameters

Response

​When to use this

​Query parameters

​Errors

​Related endpoints

Authorizations

Query Parameters

Response

When to use this

Query parameters

Errors

Related endpoints