List Calls - DialNexa Documentation

GET

calls

List Calls

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://api.dialnexa.com/v1/calls")
  .header("Authorization", "Bearer <token>")
  .asString();

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

Recommended. This endpoint is part of the public /v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.

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 for lightweight call browsing, status polling against a known set of recent calls, and quick filtering by agent or outcome. For richer per-call data, full transcripts, recording URLs, sentiment, and the structured post-call analysis fields configured on the agent, use List Call Logs instead. Call logs carry the analytics payload while /calls is the lightweight scheduling-layer view.

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.

Query parameters

Parameter	Description
`agent_id`	Return only calls placed by a specific agent.
`status`	Filter by status (`initiated`, `in-progress`, `completed`, `failed`, `busy`, `no-answer`).
`from` / `to`	ISO 8601 timestamps to bound the result by `created_at`.
`page`	Page number, starting from 1.
`limit`	Results per page (max 200, default 20). The current OpenAPI schema exposes this query value as a string; send decimal digits.

Errors

403 Forbidden is returned when the API key cannot read calls on this workspace.

Get Call Details: fetch a single call’s detail.
Trigger a Call: start a new outbound call.
List Call Logs: richer call data with transcript and analysis.
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

batch_call_id

string

Filter by batch call ID

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"

Get Call DetailsFetch one call with status, routing, transcript, and analysis details.

List Calls

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://api.dialnexa.com/v1/calls")
  .header("Authorization", "Bearer <token>")
  .asString();

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"
}

​When to use this

​Query parameters

​Errors

​Related endpoints

Authorizations

Query Parameters

Response

When to use this

Query parameters

Errors

Related endpoints