Skip to main content
GET
/
call-logs
/
{id}
Get a call log
curl --request GET \
  --url https://api.dialnexa.com/v1/call-logs/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "log_abc123",
  "call_id": "call_abc123",
  "agent_id": "agt_abc123",
  "status": "completed",
  "sentiment": "positive",
  "duration_seconds": 145,
  "recording_url": "https://recordings.dialnexa.com/call_abc123.mp3",
  "analysis": {
    "customer_satisfaction": 8
  },
  "created_at": "2024-03-01T10:00:00.000Z",
  "end_reason": "user_disconnected",
  "fallback_stt_transcriber_id": null
}
Fetches the call log for a single call: the call id, its status (completed, failed, no-answer, busy, voicemail), duration_sec, the end_reason, the high-level sentiment, the agent_id that ran the call, the destination number, and any post-call analysis fields defined on the agent. The transcript and recording URL are not returned in this lightweight log, fetch those through Get Call Details.

​
When to use this

  • CRM sync: write back the outcome and post-call analysis to the source CRM record.
  • Live dashboards: render call cards with sentiment and outcome badges.
  • Quality monitoring: flag calls where the analysis fields indicate a follow-up is required.
  • Lightweight checks: poll for completion without paying the cost of fetching the full transcript.
For the transcript, recording URL, and full event timeline, call Get Call Details. For multiple call logs filtered by date, agent, campaign, or outcome, use List Call Logs.

​
Path parameters

ParameterDescription
idThe call ID, for example call_x9y3zp4mq7r1.

​
Errors

  • 404 Not Found is returned when the call does not exist.
  • 403 Forbidden is returned when the API key cannot read call data on this workspace.

​
Request

curl "https://api.dialnexa.com/v1/call-logs/call_x9y3zp4mq7r1" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "call_x9y3zp4mq7r1",
  "status": "completed",
  "duration_sec": 142,
  "end_reason": "user_disconnected",
  "sentiment": "positive",
  "agent_id": "agt_k7m2nq9xw4p8",
  "to_phone_number": "+919876543210",
  "analysis": {
    "qualified": true,
    "follow_up_booked": false
  },
  "created_at": "2024-05-01T14:22:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Pass your API key as a Bearer token in the Authorization header.

Path Parameters

​
id
string
required

Response

Success.

​
id
string
Example:

"log_abc123"

​
call_id
string
Example:

"call_abc123"

​
agent_id
string
Example:

"agt_abc123"

​
status
enum<string>

Canonical call log status.

Available options:
created,
initiated,
sent,
received,
completed,
did_not_pick,
busy,
no_answer,
failed,
cancelled,
retry_expired
Example:

"completed"

​
sentiment
string
Example:

"positive"

​
duration_seconds
integer
Example:

145

​
recording_url
string | null
Example:

"https://recordings.dialnexa.com/call_abc123.mp3"

​
analysis
object
Example:
{ "customer_satisfaction": 8 }
​
created_at
string<date-time>
Example:

"2024-03-01T10:00:00.000Z"

​
end_reason
enum<string> | null

Canonical reason the call ended or failed.

Available options:
agent_disconnected,
user_disconnected,
user_busy,
user_did_not_pick_up,
invalid_phone_number,
unknown,
network_failure,
voicemail_detected,
user_unreachable,
destination_forbidden,
system_failure,
system_at_capacity,
insufficient_balance
Example:

"user_disconnected"

​
fallback_stt_transcriber_id
string | null

Fallback STT transcriber ID snapshotted for billing when fallback STT was active.

Example:

null