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

# Get a call

`GET /calls/{id}`

Returns a single call by ID. Accepts both integer ID and UUID. Use the expand query param to include related entities inline.

## Path parameters

- `id` string, required — Call ID (positive integer) or UUID

## Query parameters

- `expand` string — Comma-separated list of relations to expand. Allowed values: contacts, deal, account, users

## Response `200`

Call details

- CallExpanded
  - `id` number, required — Call ID
  - `name` string, required — Call title
  - `date` string, nullable, required — Call date in ISO 8601 format
  - `duration` number, nullable, required — Call duration in seconds
  - `direction` string, nullable, required — Call direction: inbound or outbound
  - `language` string, nullable, required — Detected language code (ISO 639-1)
  - `status` string, required — Public status: processing, completed, failed
  - `createdOn` string, nullable, required — Creation timestamp in ISO 8601 format
  - `modifiedOn` string, nullable, required — Last modification timestamp in ISO 8601 format
  - `phoneProviderCallId` string, required — External identifier of the call from the phone provider (e.g. Aircall, Ringover, etc.).
  - `recordingRetentionStatus` 'available' | 'deleted', required — Retention status of the call recording: "available" if the recording is kept, "deleted" if it has been deleted for data retention reasons.
  - `transcriptRetentionStatus` 'available' | 'deleted', required — Retention status of the call transcript: "available" if the transcript is kept, "deleted" if it has been deleted for data retention reasons.
  - `contacts` ContactSummary[] — Expanded contact objects. Present when expand=contacts is set.
    - `id` number, required — Contact ID
    - `name` string, nullable, required — Contact name
    - `email` string, nullable, required — Contact email
    - `phoneNumber` string, nullable, required — Contact phone number
    - `jobTitle` string, nullable, required — Contact job title
  - `contactIds` number[] — Contact IDs. Present when contacts are not expanded.
  - `deal` object, nullable — Expanded deal object. Present when expand=deal is set.
    - `id` number, required — Deal ID
    - `name` string, required — Deal name
    - `status` string, nullable, required — Deal status
    - `stage` string, nullable, required — Deal stage
    - `amount` number, nullable, required — Deal amount in the deal currency
    - `currency` string, nullable, required — Deal currency code
    - `closeDate` string, nullable, required — Expected close date in ISO 8601 format
  - `dealId` number, nullable — Deal ID. Present when deal is not expanded.
  - `account` object, nullable — Expanded account object. Present when expand=account is set.
    - `id` number, required — Account ID
    - `name` string, required — Account name
  - `accountId` number, nullable — Account ID. Present when account is not expanded.
  - `users` UserSummary[] — Expanded user objects. Present when expand=users is set.
    - `id` number, required — User ID
    - `email` string, required — User email
    - `firstName` string, nullable, required — User first name
    - `lastName` string, nullable, required — User last name
  - `userIds` number[] — User IDs. Present when users are not expanded.
  - `crmActivity` CrmActivity, nullable, required — CRM activity record linked to this call. Null if the call has not been synced to a CRM.
    - `crmId` string, required — Identifier of the activity record in the external CRM
    - `crmOrigin` 'created_by_modjo' | 'found_in_crm' | 'provided_by_provider', required — How the activity was logged in the CRM: created_by_modjo, found_in_crm, or provided_by_provider

## Other responses

- `401` — Authentication failed. The API key is missing or invalid.
- `404` — Call not found
- `429` — Rate limit exceeded. Retry after the X-RateLimit-Reset interval.

---

[API](https://skmtc.dev/modjo/apis/modjo-public-api.md) · [All operations](https://skmtc.dev/modjo/apis/modjo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modjo/modjo-public-api/revisions/dcae8b3284e8/schema)