---
title: "Get appointment by id"
method: GET
path: "/v1/appointments/{appointment_id}"
tags: ["appointments"]
---

# Get appointment by id

`GET /v1/appointments/{appointment_id}`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/appointments/{appointment_id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.zocdoc.com/oauth/token` scopes: `external.appointment.read`
  - OAuth 2
    - Authorization code: `https://auth.zocdoc.com/authorize`
    - Token URL: `https://auth.zocdoc.com/oauth/token` scopes: `external.appointment.read`

This endpoint retrieves updated appointment details and the status of a single existing appointment. Developers must send a valid `appointment_id` as input in the request body, and Zocdoc returns the appointment details and status for that appointment. See [Appointment Status definitions](/guides/glossary).

If the appointment was booked with a Zocdoc user credential, only that user will have access to view or modify the appointment. If the appointment was booked with a machine-to-machine credential, the appointment can be viewed and modified by any of the developer's machine-to-machine credentials.

## Path parameters

- `appointment_id` string, required

## Response `200`

Successful

- AppointmentStatusResponse
  - `request_id` string, required: Unique request identifier for tracing
  - `data` AppointmentStatusResponseData, required: Data that will be returned upon an a appointment lookup
    - `appointment_id` string, required: The Zocdoc ID of the appointment.
    - `appointment_status` 'pending_booking' | 'confirmed' | 'booking_failed' | 'cancelled' | 'no_show' | 'pending_reschedule' | 'rescheduled' | 'reschedule_failed', required: The status of the appointment. See [Appointment Status definitions](/guides/glossary).
    - `developer_patient_id` string: The patient identifier provided by 3P developer. Null if not provided.
    - `is_provider_resource` boolean, required: Whether the appointment will be performed by a professional under the supervision of the booked provider.
    - `location_phone_number` string: The appointment location's unformatted 10 digit phone number
    - `location_phone_extension` string: The appointment location's unformatted extension number, as digits
    - `waiting_room_path` string: Patient facing url that can be used to navigate to Zocdoc video service appointments
    - `confirmation_type` 'auto' | 'manual' | 'pending_evaluation', required: Specifies how the appointment confirmation will be handled. * auto: means the system will automatically confirm. * manual: means confirmation requires user action. * pending_evaluation: indicates that the confirmation approach is pending evaluation.
    - `start_time` string, date-time, required: Date & time of the appointment
    - `created_time_utc` string, instant: UTC date & time of the appointment creation
    - `last_modified_time_utc` string, instant: UTC date & time of the appointment last modification
    - `provider_location_id` string, required
    - `practice_id` string: The Zocdoc id of the practice
    - `visit_reason_id` string, required
    - `visit_type` 'in_person' | 'zocdoc_video_service' | 'third_party_video_service': The appointment's [visit type](/guides/glossary)
    - `patient_type` 'existing' | 'new': Whether or not the patient has been to the provider's practice.
    - `notes` string: Patient notes. 100 character maximum limit.
    - `cancellation_reason` string: Optional free text description for the appointment cancellation. Only use this field when cancellation_reason_type is set to 'other_patient_reason' or 'other_provider_reason'.
    - `source` string: The channel where the appointment was booked (e.g., "Zocdoc Marketplace", "Your website").

## Other responses

- `400`: Invalid request parameters.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found

---

[API](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api.md) - [All operations](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/revisions/965a6ca4ed12?raw)