Chat with our AI Assistant to get instant answers on APIs, troubleshooting, and integration steps.
Ask ✨
Ctrlk
Sandbox LoginPartner ContactsBecome a SiteMinder Partner
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cancel Reservation

API: Channels Plus · Operation: Reservations · Direction: Channel → SM · Method: Push (Channel-initiated)

post

Cancel an existing confirmed reservation. This endpoint allows you to cancel a confirmed reservation that has a free cancellation policy.

Important Business Rules:

  • Only reservations with policyType: "free-cancellation" can be cancelled via this endpoint

  • Non-refundable reservations (policyType: "non-refundable") cannot be cancelled and will result in a 400 error

  • Cancellation must be requested within the free cancellation period (before freeCancellationUntilDays prior to check-in)

  • Attempts to cancel outside the cancellation period will result in a 400 error

  • Pending reservations (not yet confirmed) will return a 404 error

  • Already cancelled reservations will return a 404 error

Cancellation Policy Calculation: The cancellation deadline is calculated in the property's local timezone based on the freeCancellationUntilDays value from the cancellation policy. For example, if a reservation has a check-in date of 2024-01-15 and freeCancellationUntilDays: 7, the last day to cancel is 2024-01-08 (in the property's timezone).

Successful Cancellation: A 200 response indicates the cancellation was successful. The reservation status will be updated to "Cancelled".

Path parameters
bookingReferenceIdstringRequired

The unique identifier of the reservation to be cancelled

Header parameters
x-sm-api-idstringRequired

The api id for channel

x-sm-api-keystringRequired

The api key for channel

Responses
200

Successful response. The reservation has been cancelled successfully. Note that a successful cancellation does not necessarily mean a full refund will be issued. Refunds are subject to the property's cancellation policy.

post/reservations/{bookingReferenceId}/cancellation
POST /reservations/{bookingReferenceId}/cancellation HTTP/1.1
x-sm-api-id: text
x-sm-api-key: text
Accept: */*

No content

sparkles

Still have questions?

Use the 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.

Last updated

Was this helpful?