---
title: "Update appointment status"
method: PUT
path: "/v1/appointments/update-status"
tags: ["appointments"]
---

# Update appointment status

`PUT /v1/appointments/update-status`

## Request

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

Use this endpoint to update the status of an appointment to either 'arrived' or 'no_show'.
- `arrived`: Indicates the patient has arrived at the office.
- `no_show`: Indicates the patient did not show up for their scheduled appointment. Appointment start time should be in the past but no older than 2 days to be marked as no_show.

## Request body

- ExternalUpdateAppointmentStatusRequestBody
  - `appointment_id` string, required: The Zocdoc ID of the appointment.
  - `appointment_status` 'arrived' | 'no_show', required: New status to set for the appointment. Accepted values: - `arrived`: Patient has arrived at the office. - `no_show`: Patient did not show up for their appointment.

## Response `200`

Successful status update

- AppointmentBaseResponse
  - `request_id` string, required: Unique request identifier for tracing
  - `data` AppointmentBaseResponseData, required: Data that will be returned upon a sucessful booking request
    - `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.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `500`: Internal Server Error

---

[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)