---
title: "Retrieve an appointment"
method: GET
path: "/api/business/{businessId}/branch/{branchId}/appointment/{appointmentId}"
tags: ["Appointment"]
---

# Retrieve an appointment

`GET /api/business/{businessId}/branch/{branchId}/appointment/{appointmentId}`

Retrieve an appointment for the specified business id, branch id and appointment id

## Path parameters

- `businessId` string, required
- `branchId` string, required
- `appointmentId` string, required

## Response `200`

Specified appointment retrieved

- AppointmentResponse
  - `appointmentId` string, required
  - `version` integer, required
  - `appointmentDate` string
  - `startTime` string, required
  - `endTime` string — If the staff/service is changed then the duration is calculated from the new staff/service and endTime is ignored. Otherwise the endTime given is used.
  - `price` number
  - `staffId` string, required
  - `roomId` string
  - `machineId` string
  - `confirmed` boolean
  - `serviceId` string
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `staffRequest` boolean
  - `preferredStaff` boolean
  - `clientId` string
  - `serviceRewardId` string
  - `courseId` string
  - `courseName` string
  - `clientCourseId` string
  - `clientCourseItemId` string
  - `purchasingBranchId` string
  - `serviceGroupItemOptionId` string
  - `serviceGroupId` string
  - `parentServiceGroupId` string — This is the id of a service group at a business level and corresponds to the service group id used in the booking apis
  - `serviceName` string
  - `state` 'BOOKED' | 'CHECKED_IN' | 'PAID'
  - `activationState` 'RESERVED' | 'ACTIVE' | 'CANCELED'
  - `waitingListDateTime` string, date-time
  - `depositAmount` number
  - `depositDateTime` string, date-time
  - `bookingId` string
  - `source` string
  - `groupBookingId` string
  - `deleted` boolean
  - `notes` string
  - `internetServiceCategories` InternetServiceCategory[] — Contains list of the ID and name of an internet service category that a service belongs to. This data is available only if <code>fetch_online_category</code> parameter is set to true
    - `id` string
    - `name` string
  - `branchId` string
  - `isFinishAppointment` boolean — Indicates if this appointment is the concluding segment of a split service.

## Other responses

- `400` — Bad Request
- `404` — Business, branch or appointment with the specified ids don't exist
- `429` — Request rate limit exceeded. Current limit set to 100 rps.
- `500` — Internal Server Error

---

[API](https://skmtc.net/phorest/apis/third-party-api.md) · [All operations](https://skmtc.net/phorest/apis/third-party-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phorest/third-party-api/revisions/2218bc90d39c/schema)