---
title: "GET /reservations/{bookingReferenceId}"
method: GET
path: "/reservations/{bookingReferenceId}"
---

# GET /reservations/{bookingReferenceId}

`GET /reservations/{bookingReferenceId}`

Returns information regarding a specific reservation based on the provided booking reference ID. Only confirmed and cancelled reservations will return results. Reservations in pending status will return 404.

## Path parameters

- `bookingReferenceId` string, required

## Headers

- `x-sm-api-id` string, required
- `x-sm-api-key` string, required

## Response `200`

Successful response

- object
  - `bookingReferenceId` string, required — Unique identifier for the booking.
  - `propertyUuid` string, required — The unique identifier of the property for which the reservation is made.
  - `propertyName` string, required — The name of the property.
  - `bookedOnDate` string, date, required — The date the reservation was made.
  - `checkInDate` string, date, required — The check-in date for the reservation.
  - `checkOutDate` string, date, required — The check-out date for the reservation.
  - `currencyCode` string, required — The booking currency of the reservation.
  - `paymentTotal` number, required — The total amount for the reservation, in the booking currency.
  - `totalTaxes` number, required — The total amount of taxes applied to the reservation, in the booking currency.
  - `totalFees` number, required — The total amount of fees applied to the reservation, in the booking currency.
  - `status` 'Confirmed' | 'Cancelled', required — The status of the reservation.
  - `channelCommissionPercentage` number, required — The channel commission amount for the reservation, in the booking currency.
  - `channelCommissionAmount` number, required — The channel commission amount in the reservation currency.
  - `siteminderCommissionAmount` number, required — The SiteMinder commission amount for the reservation, in the booking currency.
  - `cancellationPolicy` CancelationPolicy, required — Defines the cancellation policy for a reservation or rate. Policies can be either non-refundable or allow free cancellation up to a specified number of days before check-in.
    - `policyType` 'non-refundable' | 'free-cancellation', required — The type of cancellation policy. 'non-refundable' means no refund will be provided regardless of when cancellation occurs. 'free-cancellation' allows cancellation without penalty up to the specified number of days before check-in.
    - `freeCancellationUntilDays` number, nullable — Number of days before check-in when free cancellation is allowed. Only applicable when policyType is 'free-cancellation'. Null for non-refundable policies. For example, a value of 7 means guests can cancel up to 7 days before check-in without penalty.
  - `nonRefundableDateTime` string, date-time, nullable, required — The datetime when the reservation becomes non-refundable, in the property's timezone.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — The specified resource was not found
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/siteminder/apis/pmsx-core-api.md) · [All operations](https://skmtc.net/siteminder/apis/pmsx-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/siteminder/pmsx-core-api/versions/4cf21cbc07ec/schema)