---
title: "Get a phone call"
method: GET
path: "/public-api/v1/phone_calls/{phone_call_id}"
tags: ["phone_calls"]
---

# Get a phone call

`GET /public-api/v1/phone_calls/{phone_call_id}`

## Request

- Base URL: `/` (relative, and the document’s source URL is not known)
- URL: `/public-api/v1/phone_calls/{phone_call_id}`
- Auth: HTTP bearer and API key in header `x-tenant-code`

Retrieve one parent phone call and its nested call legs.

The response is the call object itself, not a wrapper. Use this endpoint
after locating a call through ``POST /phone_calls/list`` when the caller
needs the full per-leg detail.

## Path parameters

- `phone_call_id` string, uuid, required

## Response `200`

The requested parent phone call, including its call legs.

- CallResponse: Response body for ``GET /phone_calls/{phone_call_id}`` — the full call, with ``details``.
  - `id` string, uuid, nullable
  - `circuit_number` string, nullable
  - `dial_starts_at` string, date-time, nullable
  - `dial_ends_at` string, date-time, nullable
  - `acw_ends_at` string, date-time, nullable
  - `duration_talk` number, nullable
  - `details` AppSchemasCallsCallDetail[]
    - `id` string, uuid, nullable
    - `event_type` string, nullable
    - `answered` boolean, nullable
    - `circuit_number` string, nullable
    - `circuit_name` string, nullable
    - `from_number` string, nullable
    - `to_number` string, nullable
    - `dial_starts_at` string, date-time, nullable
    - `dial_answered_at` string, date-time, nullable
    - `dial_ends_at` string, date-time, nullable
    - `acw_ends_at` string, date-time, nullable
    - `queueing_starts_at` string, date-time, nullable
    - `queueing_answered_at` string, date-time, nullable
    - `queueing_ends_at` string, date-time, nullable
    - `monitoring_type` string, nullable
    - `group_name` string, nullable
    - `dtmf` string, nullable
    - `deleted` boolean, nullable
    - `call_type` string, nullable
    - `duration_wait` number, nullable
    - `duration_talk` number, nullable
    - `keywords` AppSchemasCallsKeyword[]
      - `participant_id` string, uuid, nullable
      - `starts_at` number, nullable
      - `value` string, nullable
    - `participants` AppSchemasCallsParticipant[]
      - `id` string, uuid, nullable
      - `from_to` string, nullable
      - `type` string, nullable
      - `name` string, nullable
      - `company_name` string, nullable
      - `analysis` AppSchemasCallsParticipantAnalysis: Per-participant audio analysis (voice metrics).
        - `f0` number, nullable
        - `speechrate` number, nullable
        - `variance` number, nullable
    - `tags` AppSchemasCallsTag[]
      - `value` string, nullable
      - `creator_type` string, nullable
    - `customers` AppSchemasCallsParticipant[]
      - `id` string, uuid, nullable
      - `from_to` string, nullable
      - `type` string, nullable
      - `name` string, nullable
      - `company_name` string, nullable
      - `analysis` AppSchemasCallsParticipantAnalysis: Per-participant audio analysis (voice metrics).
        - `f0` number, nullable
        - `speechrate` number, nullable
        - `variance` number, nullable
    - `operators` AppSchemasCallsParticipant[]
      - `id` string, uuid, nullable
      - `from_to` string, nullable
      - `type` string, nullable
      - `name` string, nullable
      - `company_name` string, nullable
      - `analysis` AppSchemasCallsParticipantAnalysis: Per-participant audio analysis (voice metrics).
        - `f0` number, nullable
        - `speechrate` number, nullable
        - `variance` number, nullable
    - `analysis` CallAnalysis: Call-quality analysis for a call detail.
      - `score` number, nullable
      - `tlr` number, nullable
      - `rally_count` integer, nullable
      - `overlap_count` integer, nullable
      - `silence_count` integer, nullable

## Other responses

- `400`: The tenant could not be resolved from the request.
- `401`: Error envelope (`public_api.unauthorized`).
- `403`: The request is not allowed for the current tenant or access configuration.
- `404`: Error envelope (`public_api.not_found`).
- `409`: Error envelope (`public_api.conflict`).
- `413`: The request body exceeds the maximum allowed size.
- `422`: Validation Error
- `429`: Rate limit exceeded. Wait for ``Retry-After`` seconds before retrying.
- `502`: Error envelope (`public_api.internal_error`).
- `503`: The request could not be served right now. Please retry.
- `504`: Error envelope (`public_api.request_timeout`).

---

[API](https://skmtc.dev/miitel/apis/miitel-public-api.md) - [All operations](https://skmtc.dev/miitel/apis/miitel-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/miitel/apis/miitel-public-api/revisions/961732756fa3?raw)