---
title: "Get specific call"
method: GET
path: "/{sub_domain}/api/calls/{id}"
tags: ["Calls"]
---

# Get specific call

`GET /{sub_domain}/api/calls/{id}`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/calls/{id}`
- Auth: API key in header `Authorization`

Retrieve a single call by its numeric `id`.

**When to use.** Drill-down to the full detail of one call, for example from a list row. Returns `404` if the id does not exist or is not visible to your API user.

**Shape.** `{ "calls": [ <call> ] }`, a single-element array that matches the list endpoint's envelope.

Gateway note: custom call fields defined on the account can be used as filter keys (path segments, see the `_filtered` variant) and are returned on each record alongside the standard fields.

## Path parameters

- `id` integer, required: Call ID.
- `sub_domain` string, required: Dialer Name (subdomain)

## Response `200`

Successful Response

- CallsResponse
  - `calls` CallItem[], required
    - `id` integer, nullable: Call ID.
    - `object_type_id` integer, nullable: Call object type: 1 = Campaign Lead Call, 2 = PhoneBook Call.
    - `object_id` integer, nullable: ID of the related object (campaign lead / phonebook entry).
    - `caller_user_id` integer, nullable: ID of the user who placed the call.
    - `caller_user` string, nullable
    - `call_uuid` string, nullable: Unique call UUID.
    - `start_at` string, nullable: Call start timestamp.
    - `end_at` string, nullable: Call end timestamp.
    - `src` string, nullable: Source number.
    - `dst` string, nullable: Destination number.
    - `call_duration` integer, nullable: Total call duration in seconds.
    - `call_bill_duration` integer, nullable: Billed call duration in seconds.
    - `cost` number, nullable: Call cost.
    - `status` string, nullable: Call status.
    - `q850` integer, nullable: Q.850 hangup cause code.
    - `sip_term_status` integer, nullable: SIP termination status.
    - `agent_callerid_name` string, nullable
    - `agent_callerid_number` string, nullable
    - `client_callerid_name` string, nullable
    - `client_callerid_number` string, nullable
    - `agent_hangup_disposition` string, nullable
    - `client_hangup_disposition` string, nullable
    - `beep_detected` integer, nullable: 1 if answering-machine beep was detected.
    - `record_file` string, nullable: Recording file name, if any.
    - `created_at` string, nullable
  - `total_calls` integer, nullable: Total number of matching calls.

## Other responses

- `404`: Not Found
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)