---
title: "Get Phone Call"
method: GET
path: "/v1/calls/{callId}"
tags: ["Calls"]
---

# Get Phone Call

`GET /v1/calls/{callId}`

Retrieves the full details of a single call record by callId. Returns call status, direction, assigned agent, phone numbers, duration, and transcript metadata.

## Path parameters

- `callId` string, required

## Response `200`

OK

- CallResponse — Full details of a single call record. Includes call identity, direction, status, timing, the agent that handled it, and the campaign it belongs to if applicable.
  - `callId` string — Unique identifier for this call. Use this value as callId when retrieving, updating, or referencing this call in subsequent API calls.
  - `callType` 'inbound' | 'outbound' | 'web' | 'chat' — Direction and channel of the call. 'inbound' means the call was received by SigmaMind from an external caller. 'outbound' means SigmaMind dialled the destination number. 'web' means the call originated from a browser-based session.
  - `phoneNumber` PhoneNumberResponse — Caller phone number used to dial contacts in this campaign. This number appears as the caller ID on recipients' devices.
    - `sipPhoneNumber` string — The caller’s phone number in +E.164 format. This number must be obtained from SigmaMind or configured using SIP trunking with SigmaMind.
    - `provider` 'twilio' | 'telnyx' | 'byo' — The service provider associated with the phone number.
    - `inboundAgentId` string — Default agent ID assigned to handle inbound calls for this phone number.
    - `outboundAgentId` string — Default agent ID assigned to handle outbound calls for this phone number.
    - `outboundPhoneNumber` string — The default outbound phone number of the callee, represented in +E.164 format
    - `active` boolean — Indicates whether the phone number is currently active and available for use.
    - `terminationSipURI` string — The SIP URI of the phone number, provided by the service provider for call termination.
    - `friendlyName` string — A user-friendly display name assigned to this phone number.
  - `campaign` CampaignResponse — Full details of a campaign record. Includes the campaign's identity, current status, schedule configuration, the agent handling calls, and the caller phone number used to dial contacts.
    - `campaignId` string — Unique identifier for this campaign. Use this value as campaignId when updating, deleting, or triggering this campaign via the API.
    - `campaignName` string — Display name of this campaign as set at creation time. Used to identify the campaign in listings and dashboards.
    - `campaignStatus` 'live' | 'scheduled' | 'paused' | 'completed' — Current lifecycle state of the campaign. 'live' means the campaign is actively dialling contacts. 'scheduled' means the campaign is configured to launch at a future date and time. 'paused' means dialling has been suspended and can be resumed. 'completed' means all contacts have been dialled and the campaign has finished.
    - `scheduledDate` string, date-time — The date and time when this campaign is scheduled to launch, including timezone. Present only when isScheduled is true. Null for campaigns that started immediately at creation.
    - `concurrentCalls` integer — Maximum number of calls allowed to be active simultaneously in this campaign. Determines dialling throughput — higher values dial more contacts in parallel. Reflects the value set at creation or last updated via the update endpoint.
    - `agent` AgentResponse — Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.
      - `name` string — The display name of the assigned agent.
      - `agentId` string — The unique identifier of the agent within the system.
      - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.
    - `phoneNumber` PhoneNumberResponse — Caller phone number used to dial contacts in this campaign. This number appears as the caller ID on recipients' devices.
      - `sipPhoneNumber` string — The caller’s phone number in +E.164 format. This number must be obtained from SigmaMind or configured using SIP trunking with SigmaMind.
      - `provider` 'twilio' | 'telnyx' | 'byo' — The service provider associated with the phone number.
      - `inboundAgentId` string — Default agent ID assigned to handle inbound calls for this phone number.
      - `outboundAgentId` string — Default agent ID assigned to handle outbound calls for this phone number.
      - `outboundPhoneNumber` string — The default outbound phone number of the callee, represented in +E.164 format
      - `active` boolean — Indicates whether the phone number is currently active and available for use.
      - `terminationSipURI` string — The SIP URI of the phone number, provided by the service provider for call termination.
      - `friendlyName` string — A user-friendly display name assigned to this phone number.
    - `errors` string[] — List of validation errors encountered when processing the campaign's contact CSV file. Present only when the upload contained rows with invalid phone numbers or missing required variables. Null or empty when the file was processed without errors.
    - `scheduled` boolean
  - `status` 'scheduled' | 'in_progress' | 'ended' | 'not_connected' | 'error' — Current lifecycle state of the call. 'scheduled' means the call is queued but dialling has not started. 'in_progress' means the call is currently active. 'ended' means the call completed normally. 'not_connected' means the call was attempted but the recipient did not answer or connect. 'error' means the system encountered a failure while trying to place or manage the call.
  - `transcript` string — transcript of the conversation in chat
  - `startTime` string, date-time — UTC timestamp when the call was connected and the active session began, in ISO 8601 format. Null if the call never reached in_progress state.
  - `endTime` string, date-time — UTC timestamp when the call session ended, in ISO 8601 format. Null if the call is still in progress or was never connected.
  - `duration` integer — Total duration of the connected call session in seconds. Measured from startTime to endTime. Null if the call was never connected.
  - `terminationReason` 'silence_timed_out' | 'agent_ended_call' | 'user_ended_call' | 'voicemail_detected' | 'ivr_detected' | 'agent_transferred_call' | 'max_call_duration_exceeded' | 'dial_telephony_permission_denied' | 'dial_invalid_destination' | 'dial_no_answer' | 'dial_user_declined' | 'dial_busy' | 'dial_failed' | 'error_credit_limit_reached' | 'error_llm' | 'error_tts' | 'error_asr' | 'error_sigmamind' | 'error_telephony' | 'error_unknown' — Reason the call session ended. 'silence_timed_out' — call ended due to configured silence timeout. 'agent_ended_call' — the AI agent closed the session. 'user_ended_call' — the recipient hung up the call. 'voicemail_detected' — voicemail was detected during the call. 'ivr_detected' — IVR system was detected during the call. 'agent_transferred_call' — the AI agent transferred the call. 'max_call_duration_exceeded' — maximum call duration limit was exceeded. 'dial_telephony_permission_denied' — outbound dialing permission was denied by telephony provider. 'dial_invalid_destination' — destination number was invalid. 'dial_no_answer' — the call rang but was not answered. 'dial_user_declined' — recipient declined the incoming call. 'dial_busy' — the destination number was busy. 'dial_failed' — outbound dialing failed due to SIP or telephony error. 'error_credit_limit_reached' — insufficient credit balance. 'error_llm' — language model failed to generate a response. 'error_tts' — text-to-speech service error occurred. 'error_asr' — speech recognition service error occurred. 'error_sigmamind' — internal SigmaMind processing error occurred. 'error_telephony' — telephony provider or connection error occurred. 'error_unknown' — unknown internal error occurred. Null if the call has not yet ended.
  - `createdAt` string, date-time — UTC timestamp when this call record was created in the system, in ISO 8601 format. For outbound calls this is typically when the call was scheduled or triggered.
  - `updatedAt` string, date-time — UTC timestamp when this call record was last updated, in ISO 8601 format. Updates occur when the call status changes, the session ends, or metadata is modified.
  - `dynamicVariables` JsonNode — Dynamic key-value pairs that were passed to the agent at call start for personalisation. Keys correspond to variable names defined in the agent's configuration (e.g., 'customer_name', 'account_id'). Null or empty if no dynamic variables were provided when the call was created.
  - `recordingUrl` string — URL of the call recording audio file. Available after the call ends and recording processing is complete. Null if recording is not enabled for this call or if the call did not connect.
  - `agent` AgentResponse — Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.
    - `name` string — The display name of the assigned agent.
    - `agentId` string — The unique identifier of the agent within the system.
    - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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