List Call Logs

GET

call-logs

Get call logs with did_not_pick, completed, and failed statuses, with optional filtering and pagination

curl --request GET \
  --url https://api.dialnexa.com/call-logs \
  --header 'Authorization: Bearer <token>' \
  --header 'if-none-match: <if-none-match>' \
  --header 'x-organization-id: <x-organization-id>'

import requests

url = "https://api.dialnexa.com/call-logs"

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

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

print(response.text)

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

fetch('https://api.dialnexa.com/call-logs', 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/call-logs",
  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>",
    "if-none-match: <if-none-match>",
    "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/call-logs"

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

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

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/call-logs")

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

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

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

Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. A public v1 replacement is not currently listed in the v1 reference. This endpoint remains available for existing integrations until then.

Returns enriched call logs for your organization. Unlike the basic Calls endpoint, call logs include sentiment scores, call outcome, duration, and any custom fields extracted by your agent’s post-call analysis.

When to use this

Use call logs when building:

Analytics dashboards with outcome metrics
Quality assurance reviews
CRM sync pipelines (push outcome data back to your system)
Exportable reports filtered by date range or sentiment

ETag caching

This endpoint supports HTTP ETags. On the first request, the server returns an ETag header. On subsequent requests, pass that value as If-None-Match. If the data has not changed, you’ll receive a 304 Not Modified with no body, which saves bandwidth and reduces latency on polling setups.

Key query parameters

Parameter	Description
`agent_id`	Filter logs by a specific agent.
`status`	Filter by one call outcome status or comma-separated statuses.
`sentiment`	Filter by detected sentiment: `positive`, `neutral`, or `negative`.
`end_reason`	Filter by one exact hang up reason or comma-separated `end_reason` values.
`start_date` / `end_date`	Date range filter (YYYY-MM-DD).
`duration_min` / `duration_max`	Filter by call duration in milliseconds.
`created_at`	Sort order, either `asc` or `desc`.
`duration` sort	When sorting by duration, failed or incomplete calls with zero or empty duration are placed after calls with real durations.

End Reasons

Call logs can include end_reason when the platform can identify why the call ended or failed.

End reason	Meaning
`user_disconnected`	The caller or recipient ended the call.
`agent_disconnected`	The agent or DialNexa side ended the call.
`user_did_not_pick_up`	The destination did not answer.
`user_busy`	The destination line was busy or rejected the call.
`user_unreachable`	The carrier reported a temporary unreachable state.
`invalid_phone_number`	The destination number could not be reached because the number is invalid.
`destination_forbidden`	The carrier or route blocked the destination.
`network_failure`	A carrier or network failure prevented completion.
`voicemail_detected`	Voicemail was detected.
`system_failure`	DialNexa or the speech service failed after retry handling.
`system_at_capacity`	A provider capacity or rate-limit condition exhausted retry handling.
`insufficient_balance`	The call could not start because wallet balance was insufficient.
`unknown`	No more specific reason was available.

Authorizations

Authorization

string

header

required

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

Headers

if-none-match

string

required

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 call logs with optional filtering and pagination

Get Call LogFetch the log entry for a single call, including outcome, sentiment, duration, and post-call analysis fields.

Get call logs with did_not_pick, completed, and failed statuses, with optional filtering and pagination

curl --request GET \
  --url https://api.dialnexa.com/call-logs \
  --header 'Authorization: Bearer <token>' \
  --header 'if-none-match: <if-none-match>' \
  --header 'x-organization-id: <x-organization-id>'

import requests

url = "https://api.dialnexa.com/call-logs"

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

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

print(response.text)

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

fetch('https://api.dialnexa.com/call-logs', 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/call-logs",
  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>",
    "if-none-match: <if-none-match>",
    "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/call-logs"

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

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

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/call-logs")

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

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

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

Overview

Endpoints - v1

Endpoints - Legacy

Code Examples And SDK Status

When to use this

ETag caching

Key query parameters

End Reasons

Authorizations

Headers

Query Parameters

Response

​When to use this

​ETag caching

​Key query parameters

​End Reasons

Authorizations

Headers

Query Parameters

Response

When to use this

ETag caching

Key query parameters

End Reasons