# Reservation Detail
## 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.
```json
{"openapi":"3.0.0","info":{"title":"Channels Plus Channel API","version":"0.0.1"},"paths":{"/reservations/{bookingReferenceId}":{"get":{"operationId":"showReservation","description":"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.","parameters":[{"$ref":"#/components/parameters/SmApiId"},{"$ref":"#/components/parameters/SmApiKey"},{"name":"bookingReferenceId","in":"path","required":true,"description":"The unique identifier of the reservation. Only one booking reference ID can be passed per request.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","headers":{},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"bookingReferenceId":{"type":"string","description":"Unique identifier for the booking."},"propertyUuid":{"type":"string","description":"The unique identifier of the property for which the reservation is made."},"propertyName":{"type":"string","description":"The name of the property."},"bookedOnDate":{"type":"string","format":"date","description":"The date the reservation was made."},"checkInDate":{"type":"string","format":"date","description":"The check-in date for the reservation."},"checkOutDate":{"type":"string","format":"date","description":"The check-out date for the reservation."},"currencyCode":{"type":"string","description":"The booking currency of the reservation."},"paymentTotal":{"type":"number","description":"The total amount for the reservation, in the booking currency."},"totalTaxes":{"type":"number","description":"The total amount of taxes applied to the reservation, in the booking currency."},"totalFees":{"type":"number","description":"The total amount of fees applied to the reservation, in the booking currency."},"status":{"type":"string","enum":["Confirmed","Cancelled"],"description":"The status of the reservation."},"channelCommissionPercentage":{"type":"number","description":"The channel commission amount for the reservation, in the booking currency."},"channelCommissionAmount":{"type":"number","description":"The channel commission amount in the reservation currency."},"siteminderCommissionAmount":{"type":"number","description":"The SiteMinder commission amount for the reservation, in the booking currency."},"cancellationPolicy":{"$ref":"#/components/schemas/CancelationPolicy","nullable":true,"description":"The cancellation policy applicable to this reservation."},"nonRefundableDateTime":{"type":"string","format":"date-time","nullable":true,"description":"The datetime when the reservation becomes non-refundable, in the property's timezone."}},"required":["bookingReferenceId","propertyUuid","propertyName","bookedOnDate","checkInDate","checkOutDate","currencyCode","paymentTotal","totalTaxes","totalFees","status","channelCommissionPercentage","channelCommissionAmount","siteminderCommissionAmount","cancellationPolicy","nonRefundableDateTime"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}}},"components":{"parameters":{"SmApiId":{"name":"x-sm-api-id","description":"The api id for channel","required":true,"in":"header","schema":{"type":"string"}},"SmApiKey":{"name":"x-sm-api-key","description":"The api key for channel","required":true,"in":"header","schema":{"type":"string"}}},"schemas":{"CancelationPolicy":{"type":"object","additionalProperties":false,"description":"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.","properties":{"policyType":{"type":"string","enum":["non-refundable","free-cancellation"],"description":"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":{"type":"number","nullable":true,"description":"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."}},"required":["policyType"]},"Error":{"type":"object","required":["errors"],"properties":{"errors":{"minItems":1,"type":"array","description":"An array of error objects, for most errors, this array would only contain one error object. An errors array must contain at least one error object.","items":{"type":"object","required":["code"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"meta":{"type":"object"}}}}}}},"responses":{"BadRequest":{"description":"Invalid request","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"The specified resource was not found","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServerError":{"description":"Unexpected error occurred","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```
{% hint style="success" icon="sparkles" %}
## Still have questions?
Use the :gitbook-assistant: **Ask** button at the top of the page to chat with our AI assistant — it can help you navigate the guide, understand requirements, and troubleshoot issues.
If you need more support, visit [Integration Support](/integration-support/integration-support.md).
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.siteminder.com/channels-plus-api/reference/reservation-detail.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.