> ## Documentation Index
> Fetch the complete documentation index at: https://dialnexa.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Call Details
> Fetch one call with status, routing, transcript, and analysis details.
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](/docs/api-reference/v1/migrating-to-v1) for versioning guidance.
Fetches the complete record for a single call by `call_id`. The response includes the call's current `status`, the destination and source numbers, the assigned `agent_id`, timestamps for when the call was placed and when it ended, and, once the call reaches a terminal state, the duration, recording URL, and transcript. Use this endpoint to poll for completion after triggering a call, render a call detail page, or sync per-call data into a downstream system.
## When to use this
* **Synchronous workflows**: trigger a call and poll until it reaches a terminal status before continuing.
* **Operational dashboards**: render a call detail view with status, duration, and the linked agent.
* **CRM sync**: write back the call outcome to the customer record the call was made for.
## Polling vs. webhooks
For production traffic, webhooks are the preferred way to know when a call has ended, they avoid the request volume and latency of repeated polling. Subscribe to `call.completed` and `call.failed` via [Create Webhook](/docs/api-reference/v1/webhooks/create) and use this endpoint only when you specifically need to fetch the latest state on demand (for example, a user opens a call detail page).
When polling is required, the call's `status` transitions from `initiated` to `in-progress`, then to one of `completed`, `failed`, `busy`, or `no-answer`. Poll every 5 to 10 seconds with an exponential cap; do not poll faster than once per second.
## Path parameters
| Parameter | Description |
| --------- | ------------------------------------------------------------------------------------ |
| `id` | The call ID, for example `call_abc123`. Accepted with or without the `call_` prefix. |
## Errors
* `400 Bad Request` is returned when the call ID format is invalid.
* `401 Unauthorized` is returned when the API key is missing or invalid.
* `403 Forbidden` is returned when the call does not belong to your organization.
* `404 Not Found` is returned when the call does not exist.
* `500 Internal Server Error` is returned on an unexpected server-side failure.
## Related endpoints
* [Trigger a Call](/docs/api-reference/v1/calls/create): start an outbound call.
* [List Calls](/docs/api-reference/v1/calls/list): paginate across many calls.
* [Get Call Details](/docs/api-reference/call-logs/get-details): full transcript and post-call analysis.
* [Create Webhook](/docs/api-reference/v1/webhooks/create): subscribe to `call.completed` instead of polling.
## OpenAPI
````yaml GET /v1/calls/{id}
openapi: 3.0.0
info:
title: DialNexa API
description: >-
Public REST API for the DialNexa voice AI platform. Versioned endpoints are
under /v1; unversioned endpoints are legacy and deprecated.
version: 1.0.0
servers:
- url: https://api.dialnexa.com
description: DialNexa production API
security:
- bearer: []
tags:
- name: API Keys
- name: Agent Functions
- name: Agents V1
- name: Agents2
- name: Batch Calls
- name: Batch Calls V1
- name: Call Logs
- name: Calls
- name: Calls V1
- name: Campaign Leads
- name: Campaigns
- name: External Webhooks
- name: Knowledge Base
- name: Knowledge Base V1
- name: LLMs
- name: LLMs V1
- name: Languages
- name: Languages V1
- name: Organization Phone Numbers
- name: Organization Phone Numbers V1
- name: Phone Number Pricing
- name: Phone Number Pricing V1
- name: Transcribers
- name: Transcribers V1
- name: User Webhooks
- name: User Webhooks V1
- name: V1
- name: Voices
- name: Voices V1
- name: Webcall
- name: Workflow Leads
- name: Workflow Leads V1
- name: Workflows
- name: Workflows V1
paths:
/v1/calls/{id}:
get:
tags:
- Calls
- Calls V1
- V1
summary: Get Call Details
description: >-
Returns the current call record, including routing, status, transcript,
and analysis fields when available.
operationId: CallsV1Controller_findOne
parameters:
- name: id
required: true
in: path
description: Call ID
schema:
type: string
example: call_abc123
responses:
'200':
description: Call returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/CallLogs'
examples:
success:
summary: Successful response
value:
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
transcript: >-
Agent: Hello Priya. User: I am interested in the loan
offer.
summary: Customer asked for details about the loan offer.
'400':
description: Invalid call ID format.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
error:
summary: 400 Bad Request
value:
statusCode: 400
message: Invalid call ID format
error: Bad Request
'401':
description: Unauthorized.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
error:
summary: 401 Unauthorized
value:
statusCode: 401
message: API key is missing or invalid
error: Unauthorized
'403':
description: Forbidden - call does not belong to your organization.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
error:
summary: 403 Forbidden
value:
statusCode: 403
message: You do not have permission to access this call
error: Forbidden
'404':
description: Call not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
error:
summary: 404 Not Found
value:
statusCode: 404
message: Call not found
error: Not Found
'500':
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
error:
summary: 500 Internal Server Error
value:
statusCode: 500
message: Internal server error
error: Internal Server Error
security:
- bearer: []
components:
schemas:
CallLogs:
type: object
properties:
id:
type: string
example: call_abc123
description: Signed call ID
required:
- id
ErrorResponse:
type: object
properties:
statusCode:
type: integer
example: 400
message:
oneOf:
- type: string
- type: array
items:
type: string
example: phone_number must be a valid E.164 phone number
error:
type: string
example: Bad Request
required:
- statusCode
- message
- error
securitySchemes:
bearer:
scheme: bearer
bearerFormat: JWT
type: http
````