---
title: "Get Patient Call"
method: GET
path: "/api/v0/patient-calls/calls/{id}"
---

# Get Patient Call

`GET /api/v0/patient-calls/calls/{id}`

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- ExternalPatientCall
  - `id` string, required — Unique generated (uuid4) id for the patient call
  - `status` 'SCHEDULED' | 'IN_PROGRESS' | 'SUCCESS' | 'UNSUCCESSFUL' | 'CANCELLED' | 'UNKNOWN', required — An enumeration.
  - `request` ExternalPatientCallRequest, required
    - `type` 'PATIENT_OUTREACH' — An enumeration.
    - `patient_name` string, required — Name of the patient to call
    - `patient_phone` string, required — Phone number to dial. E.164 format preferred (e.g. +14155552671).
    - `desired_call_ts` string, date-time — When to place the call, as an ISO 8601 timestamp. If omitted, the call is scheduled to start within the next 5 minutes.
    - `call_script_id` string, required — ID of a call script belonging to your team. Create and manage scripts in the dashboard under Call Scripts. The script defines the questions asked when the patient answers live.
    - `voice` 'KRISPIN' | 'RONALD' | 'PRIYA' | 'DEVANSH', required — Curated Cartesia voices available for patient calls. Friendly names map to internal Cartesia voice IDs when dialing is activated.
    - `external_id` string — Optional identifier you define for tracking (e.g. provider or campaign id).
    - `metadata` object — Key/value pairs available to the agent while it runs the call script during the live call (e.g. medication name, appointment time). Also returned on the call response and webhooks.
    - `leave_voicemail_if_no_answer` boolean — If true, leave a voicemail when the patient does not answer. Voicemail is a fallback for unanswered calls, not a separate product.
    - `voicemail_script` string — Message to leave if leave_voicemail_if_no_answer is true. Required when leave_voicemail_if_no_answer is true once the API is activated.
  - `outcome` 'LIVE_ANSWERED' | 'VOICEMAIL_LEFT' | 'NO_ANSWER' | 'FAILED' — An enumeration.
  - `voicemail_left` boolean — True if a voicemail was left as a fallback when the patient did not answer.
  - `answers` ExternalPatientCallAnswer[] — Structured answers collected from the call script when the patient answered live.
    - `question_id` string, required — ID of the question from the call script
    - `question_text` string, required — Text of the question that was asked
    - `answer` string — Answer captured during the live call
  - `call_summary` string — Short summary of the call outcome
  - `recording_url` string — URL of the call recording, if your team is entitled to recordings.
  - `creation_ts` string, date-time, required — Timestamp when the call was created
  - `completed_at` string, date-time — Timestamp when the call reached a terminal status

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/healthharbor/apis/health-harbor.md) · [All operations](https://skmtc.net/healthharbor/apis/health-harbor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/healthharbor/health-harbor/revisions/f1047899ad24/schema)