---
title: "Get an appointment"
method: GET
path: "/appointments/{id}"
tags: ["Appointment"]
---

# Get an appointment

`GET /appointments/{id}`

Returns the appointment

## Path parameters

- `id` string, required

## Query parameters

- `id_is_partner` boolean, required
- `include_events` boolean
- `include_notes` boolean
- `include_custom_field_values` boolean
- `include_segment_employees` boolean

## Headers

- `X-Subdomain` string

## Response `200`

Appointment response

- Appointment
  - `purchased_at_price` number
  - `begin_at` string, required
  - `end_at` string, required
  - `client_name` string
  - `client_email` string
  - `created_at` string
  - `status` string
  - `time_zone` string
  - `is_existing_customer` string
  - `client_phone` string
  - `variation_name` string
  - `full_address` string
  - `employee_partner_id` integer
  - `location_partner_id` integer
  - `client_partner_id` integer
  - `mytime_id` string
  - `client_mobile_phone` string
  - `client_home_phone` string
  - `client_work_phone` string
  - `checked_in_at` string
  - `checked_in` string
  - `checked_out_at` string
  - `pos_status` string
  - `address_id` string
  - `employee_requested` string
  - `child_partner_id` integer
  - `employee_mytime_id` integer, required
  - `location_mytime_id` integer, required
  - `client_mytime_id` integer, required
  - `child_mytime_id` integer
  - `variations` Variation[]
    - `price` number, required — Total charge for this variation. For multi-day stays (e.g. boarding), this is the total for the entire stay. When "multiplier_base_price" and "price_multiplier" are sent, this must equal their product.
    - `multiplier_base_price` number — Per-unit base price. Must be sent together with "price_multiplier" or omitted entirely.
    - `price_multiplier` integer — Number of units the base price is multiplied by (e.g. minutes, attendees). Must be sent together with "multiplier_base_price" or omitted entirely.
    - `variation_partner_id` string, required — Partner-side identifier of the service being booked.
    - `variation_mytime_id` string, required — MyTime identifier of the service being booked. Pull from GET /variations.
    - `parent_id` string — For add-on variations, references the parent variation in the same request. Match the parent’s variation_partner_id if provided, otherwise the parent’s variation_mytime_id (integer or string both accepted). The parent must appear earlier in the variations array than any add-on referencing it — an add-on cannot be the first entry, or the relationship is silently dropped. The add-on must also be configured as connectable to that parent service in the merchant catalog; otherwise the request fails with "Add-on cannot be added-on for variation <id>".
    - `variation_employee_id` string — Staff assigned to this specific variation. Distinct from the appointment-level employee_mytime_id query param — lets different variations within one appointment be performed by different staff (e.g. a stylist for the cut and a colorist for the color).
    - `variation_begin_at` string — Pins this variation to a specific start time within the appointment window. ISO 8601, e.g. 2026-05-15T10:00:00Z.
    - `variation_end_at` string — Pins this variation to a specific end time within the appointment window. See variation_begin_at. ISO 8601.
  - `custom_field_values` CustomFieldValue[]
    - `value` string
    - `custom_field_partner_id` string
    - `id` integer
    - `custom_field_mytime_id` integer
  - `events` Event[]
    - `action` string
    - `occurred_at` string
    - `appointment_previous_begin_at` string
    - `appointment_begin_at` string
    - `employee_partner_id` integer
  - `partner_id` integer
  - `appointment_group_id` integer — ID of the appointment group this appointment belongs to, or null if it is not part of a group.

## Other responses

- `401` — Unauthorized
- `422` — Invalid parameters
- `500` — Internal Server Error
- `504` — Gateway Timeout

---

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