List Calls

GET

calls

Get all calls for the organization

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

import requests

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

headers = {
    "x-organization-id": "<x-organization-id>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

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

fetch('https://api.dialnexa.com/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/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>",
    "x-organization-id: <x-organization-id>"
  ],
]);

$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/calls"

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

	req.Header.Add("x-organization-id", "<x-organization-id>")
	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/calls")
  .header("x-organization-id", "<x-organization-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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

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

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

[
  {
    "id": "call_abc123"
  }
]

Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.

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 100, default 20).

Errors

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

Get Call: 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.

Headers

x-organization-id

string

required

Encrypted ID of the organization

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

Response

Return all calls for the organization

string

required

Signed call ID

Example:

"call_abc123"

Get CallFetch the full record for a single call, including status, duration, agent details, and once available, the recording URL and transcript.

Get all calls for the organization

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

import requests

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

headers = {
    "x-organization-id": "<x-organization-id>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

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

fetch('https://api.dialnexa.com/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/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>",
    "x-organization-id: <x-organization-id>"
  ],
]);

$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/calls"

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

	req.Header.Add("x-organization-id", "<x-organization-id>")
	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/calls")
  .header("x-organization-id", "<x-organization-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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

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

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

[
  {
    "id": "call_abc123"
  }
]

Overview

Endpoints - v1

Endpoints - Legacy

Code Examples And SDK Status

When to use this

Query parameters

Errors

Authorizations

Headers

Query Parameters

Response

​When to use this

​Query parameters

​Errors

​Related endpoints

Authorizations

Headers

Query Parameters

Response

When to use this

Query parameters

Errors

Related endpoints