---
title: "RetrieveBooking"
method: GET
path: "/v2/bookings/{booking_id}"
tags: ["Bookings"]
---

# RetrieveBooking

`GET /v2/bookings/{booking_id}`

Retrieves a booking.

## Path parameters

- `booking_id` string, required

## Response `200`

Success

- RetrieveBookingResponse
  - `booking` Booking — Represents a booking as a time-bound service contract for a seller's staff member to provide a specified service at a given location to a requesting customer in one or more appointment segments.
    - `appointment_segments` AppointmentSegment[] — A list of appointment segments for this booking.
      - `duration_minutes` integer, required — The time span in minutes of an appointment segment.
      - `service_variation_id` string, required — The ID of the [CatalogItemVariation](https://developer.squareup.com/reference/square_2021-08-18/objects/CatalogItemVariation) object representing the service booked in this segment.
      - `service_variation_version` integer, required — The current version of the item variation representing the service booked in this segment.
      - `team_member_id` string, required — The ID of the [TeamMember](https://developer.squareup.com/reference/square_2021-08-18/objects/TeamMember) object representing the team member booked in this segment.
    - `created_at` string — The timestamp specifying the creation time of this booking, in RFC 3339 format.
    - `customer_id` string — The ID of the [Customer](https://developer.squareup.com/reference/square_2021-08-18/objects/Customer) object representing the customer attending this booking
    - `customer_note` string — The free-text field for the customer to supply notes about the booking. For example, the note can be preferences that cannot be expressed by supported attributes of a relevant [CatalogObject](https://developer.squareup.com/reference/square_2021-08-18/objects/CatalogObject) instance.
    - `id` string — A unique ID of this object representing a booking.
    - `location_id` string — The ID of the [Location](https://developer.squareup.com/reference/square_2021-08-18/objects/Location) object representing the location where the booked service is provided.
    - `seller_note` string — The free-text field for the seller to supply notes about the booking. For example, the note can be preferences that cannot be expressed by supported attributes of a specific [CatalogObject](https://developer.squareup.com/reference/square_2021-08-18/objects/CatalogObject) instance. This field should not be visible to customers.
    - `start_at` string — The timestamp specifying the starting time of this booking, in RFC 3339 format.
    - `status` string — The status of the booking, describing where the booking stands with respect to the booking state machine.
    - `updated_at` string — The timestamp specifying the most recent update time of this booking, in RFC 3339 format.
    - `version` integer — The revision number for the booking used for optimistic concurrency.
  - `errors` Error[] — Any errors that occurred during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/versions/8d95e3639487/schema)