---
title: "Retrieve the list of appointments of a center"
method: GET
path: "/v1/appointments"
---

# Retrieve the list of appointments of a center

`GET /v1/appointments`

This API retrieves the list of all appointments of the specified center between the start date and end date.

You must provide appropriate details for the `center_id`, `start_date`, and `end_date` parameters. Optionally, you can also specify the details for the `include_no_show_cancel` and `therapist_id` parameters to filter the results.

The difference between the `start_date` and `end_date` cannot be more than seven days.
The response also includes block-out times.

## Query parameters

- `center_id` string, required
- `start_date` string, date, required
- `end_date` string, date, required
- `include_no_show_cancel` boolean
- `therapist_id` string

## Response `200`

200

- union
  - object[]
    - `appointment_id` string
    - `appointment_segment_id` unknown
    - `appointment_group_id` string
    - `invoice_id` string
    - `service` object
      - `id` string
      - `name` string
      - `is_addon` boolean
      - `has_addons` boolean
      - `parent_appointment_id` unknown
      - `business_unit` object
        - `guid` string
        - `name` string
        - `id` integer
      - `category` object
        - `id` string
        - `name` string
      - `sub_category` object
        - `id` string
        - `name` string
      - `override_product_consumption` boolean
      - `override_default_product_consumption` boolean
    - `start_time` string
    - `start_time_utc` string
    - `end_time` string
    - `end_time_utc` string
    - `status` integer
    - `source` integer
    - `progress` integer
    - `locked` boolean
    - `invoice_locked` boolean
    - `has_active_membership_for_auto_pay` boolean
    - `guest` object
      - `id` string
      - `first_name` string
      - `last_name` string
      - `gender` integer
      - `mobile` object
        - `country_id` integer
        - `number` unknown
        - `display_number` string
      - `email` string
      - `indicator` string
      - `lp_tier_info` string
      - `GuestIndicatorValue` unknown
    - `therapist` object
      - `id` string
      - `first_name` string
      - `last_name` string
      - `nick_name` unknown
      - `display_name` unknown
      - `email` string
      - `gender` integer
      - `vanity_image_url` string
    - `room` unknown
    - `equipment` unknown
    - `service_custom_data_indicator` string
    - `notes` unknown
    - `price` unknown
    - `actual_start_time` unknown
    - `actual_completed_time` unknown
    - `checkin_time` unknown
    - `therapist_preference_type` integer
    - `form_id` string
    - `blockout` unknown
    - `creation_date` string
    - `creation_date_utc` string
    - `created_by_id` string
    - `closed_by_id` unknown
    - `show_in_calender` integer
    - `available_therapists` unknown
    - `available_rooms` unknown
    - `available_times` unknown
    - `selected_therapist_id` unknown
    - `selected_room_id` unknown
    - `selected_time` string
    - `requested_alternative` integer
    - `group_invoice_id` unknown
    - `error` unknown
  - object[]
    - `appointment_id` string
    - `appointment_segment_id` unknown
    - `parent_service_name` string
    - `appointment_group_id` string
    - `invoice_id` string
    - `service` object
      - `id` string
      - `segment_id` string
      - `name` string
      - `is_addon` boolean
      - `has_addons` boolean
      - `parent_appointment_id` unknown
      - `business_unit` object
        - `guid` string
        - `name` string
        - `id` integer
      - `category` object
        - `id` string
        - `name` string
      - `sub_category` object
        - `id` string
        - `name` string
      - `override_product_consumption` boolean
      - `override_default_product_consumption` boolean
      - `is_virtual_service` boolean
    - `start_time` string
    - `start_time_utc` string
    - `end_time` string
    - `end_time_utc` string
    - `status` integer
    - `source` integer
    - `progress` integer
    - `locked` boolean
    - `invoice_locked` boolean
    - `has_active_membership_for_auto_pay` boolean
    - `auto_pay_authorize_status` integer
    - `has_unexpired_packages` boolean
    - `guest` object
      - `id` string
      - `first_name` string
      - `last_name` string
      - `gender` integer
      - `mobile` object
        - `country_id` integer
        - `number` unknown
        - `display_number` string
      - `email` unknown
      - `indicator` string
      - `lp_tier_info` string
      - `is_virtual_user` boolean
      - `preferred_pronoun` string
      - `GuestIndicatorValue` object
        - `HighSpender` unknown
        - `Member` integer
        - `LowFeedback` unknown
        - `RegularGuest` unknown
        - `FirstTimer` unknown
        - `ReturningCustomer` unknown
        - `NoShow` unknown
        - `HasActivePackages` unknown
        - `HasProfileAlerts` unknown
        - `OtherCenterGuest` unknown
        - `HasCTA` unknown
        - `Dues` boolean
        - `CardOnFile` unknown
        - `AutoPayEnabled` unknown
        - `RecurrenceAppointment` unknown
        - `RebookedAppointment` boolean
        - `hasAddOns` unknown
        - `LpTier` unknown
        - `IsSurpriseVisit` unknown
        - `CustomDataIndicator` unknown
        - `IsGuestBirthday` unknown
        - `showGuestNotes` unknown
        - `NonExpirePackages` unknown
        - `NonExpireandNotClosedPackages` unknown
        - `HasFrozenPackages` unknown
        - `GuestIconInformation` unknown
        - `IsMinor` unknown
    - `therapist` object
      - `id` string
      - `first_name` string
      - `last_name` string
      - `nick_name` unknown
      - `display_name` unknown
      - `email` string
      - `gender` integer
      - `vanity_image_url` string
    - `room` object
      - `id` string
      - `name` string
    - `equipment` unknown
    - `service_custom_data_indicator` string
    - `notes` unknown
    - `group_notes` unknown
    - `price` object
      - `currency_id` integer
      - `sales` integer
      - `tax` integer
      - `final` integer
      - `final1` integer
      - `discount` integer
      - `tip` integer
      - `ssg` unknown
      - `rounding_correction` integer
    - `actual_start_time` unknown
    - `actual_completed_time` unknown
    - `checkin_time` unknown
    - `therapist_preference_type` integer
    - `form_id` unknown
    - `blockout` unknown
    - `creation_date` string
    - `creation_date_utc` string
    - `created_by_id` string
    - `closed_by_id` unknown
    - `show_in_calender` integer
    - `cancel_or_no_show_status` integer
    - `email_link` unknown
    - `sms_link` unknown
    - `appointment_category_id` unknown
    - `invoice_processed_in_integrations` integer
    - `parallel_group_id` unknown
    - `is_single_appointment` boolean
    - `available_therapists` unknown
    - `available_rooms` unknown
    - `available_times` unknown
    - `selected_therapist_id` unknown
    - `selected_room_id` unknown
    - `selected_time` string
    - `requested_alternative` integer
    - `group_invoice_id` unknown
    - `group_name` unknown
    - `canUpdateTherapist` boolean
    - `package_id` string
    - `virtual_room_link` unknown
    - `invoice_item_id` string
    - `quantity` integer
    - `is_feedback_filled` boolean
    - `is_product_consumption_updated` boolean
    - `are_custom_fields_filled` unknown
    - `are_package_targets_required` boolean
    - `are_package_targets_filled` boolean
    - `is_prescription_signed` unknown
    - `is_educator_rating_filled` boolean
    - `app_count` integer
    - `error` unknown
    - `appointment_type` integer
    - `package_name` unknown

---

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