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

# Get an appointment group

`GET /appointment_groups/{id}`

Returns an appointment group and, optionally, the join records identifying every appointment that belongs to it. Use this to retrieve the full set of appointments that share a single ticket / booking flow.

## Path parameters

- `id` integer, required

## Query parameters

- `appointment_group_items` boolean

## Headers

- `X-Subdomain` string

## Response `200`

Appointment group response

- object
  - `appointment_group` AppointmentGroup
    - `id` integer — Group id. Pass this value as `appointment_group_id` on the appointment endpoints to attach an appointment to this group.
    - `company_id` integer — Id of the company that owns the group.
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `appointment_group_items` AppointmentGroupItem[] — Join records linking each member appointment to the group. Only returned when the `appointment_group_items` query param is set on `GET /appointment_groups/{id}`.
      - `id` integer — Id of the join record.
      - `appointment_group_id` integer — Id of the parent appointment group.
      - `appointment_id` integer — Id of the grouped appointment. Look up details via `GET /appointments/{id}`.
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

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