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

# Get a call

`GET /v1/calls/{id}`

Returns a single call by ID. Returns 404 if the call is in a workspace outside the API key scope.

## Path parameters

- `id` string, required

## Response `200`

The call

- CallWithContactDTO
  - `id` string, required — Unique identifier of the call history entry
  - `callType` 'CALL_SESSION' | 'DIRECT_CALL', required — Type of the call history entry (e.g., CALL_SESSION, DIRECT_CALL)
  - `phoneNumberId` string — Unique identifier of the phone number used for the call
  - `userProviderSid` string — Provider SID for the user side of the call
  - `adminProviderSid` object, nullable — Provider SID for the admin side of the call
  - `providerConferenceId` string — Provider conference ID
  - `status` string, required — Status of the call
  - `type` string, required — Type of call (e.g., outbound, inbound)
  - `transferred` boolean — Indicates if the call was transferred
  - `startedAt` object, nullable, required — Start time of the call
  - `endedAt` object, nullable, required — End time of the call
  - `createdAt` string, date-time, required — Date and time when the call history entry was created
  - `updatedAt` string, date-time — Date and time when the call history entry was last updated
  - `sequenceRunId` string — Unique identifier of the related sequence run
  - `sequenceId` string — Unique identifier of the parent sequence
  - `syncedWithCrmDate` object, nullable — Date and time when the call was synced with CRM
  - `deletedAt` string, date-time, nullable — Date and time when the call history entry was deleted
  - `organizationId` string — Unique identifier of the organization
  - `organizationMembershipId` string — Unique identifier of the organization membership
  - `managedPhoneNumberId` string — Unique identifier of the managed phone number
  - `notes` string — Notes associated with the call
  - `contact` CallContactSummaryDTO, required
    - `id` string, required — Unique identifier of the contact
    - `firstName` string, required — First name of the contact
    - `lastName` string, required — Last name of the contact
    - `isUnknown` boolean, required — Whether this is an unknown contact (not in the system)
  - `phoneNumber` CallPhoneNumberSummaryDTO, required
    - `value` string, required — The phone number value
  - `caller` CallCallerSummaryDTO, required
    - `firstName` string, required — First name of the caller
    - `lastName` string, required — Last name of the caller
  - `callerPhoneNumber` CallPhoneNumberSummaryDTO, required
    - `value` string, required — The phone number value

## Other responses

- `401` — Invalid or missing API key
- `403` — Subscription required or plan not eligible
- `404` — Call not found or outside API key scope

---

[API](https://skmtc.net/skipcall/apis/skipcall-public-api.md) · [All operations](https://skmtc.net/skipcall/apis/skipcall-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skipcall/skipcall-public-api/versions/f594352719bd/schema)