Help us improve the Developer Guide! Share your feedback using the “Was this helpful?” option on the right of each page.

Lock Reservation

post

Create a pending reservation to lock in rates and availabilities for a specific property. This endpoint allows you to temporarily hold a reservation before confirming it, ensuring the rates and room availability are secured for a short period.

Path parameters
uuidstringRequired

The unique identifier of the property for which the reservation is being made

Header parameters
x-sm-api-idstringRequired

The api id for channel

x-sm-api-keystringRequired

The api key for channel

Body
checkinstring · dateRequired

The arrival date. Must be within 500 days in the future and in the format yyyy-mm-dd.

checkoutstring · dateRequired

The departure date. Must be later than checkin. Must be between 1 and 30 days after checkin. Must be within 500 days in the future and in the format yyyy-mm-dd.

dealCodestring | nullableOptional

The code of any deal to be applied to the reservation. If null, no deal will be applied.

netInvoicingbooleanOptional

Indicates whether net invoicing should be applied to the reservation.

Default: false
Responses
200
Successful response. A pending reservation has been created.
application/json
post
POST /properties/{uuid}/reservations HTTP/1.1
Host: 
x-sm-api-id: text
x-sm-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 162

{
  "checkin": "2025-06-23",
  "checkout": "2025-06-23",
  "dealCode": "text",
  "netInvoicing": false,
  "rooms": [
    {
      "roomRateUuid": "text",
      "adults": 1,
      "children": 1,
      "applyDeal": true
    }
  ]
}
{
  "propertyUuid": "text",
  "propertyEmail": "text",
  "propertyPhoneNumber": "text",
  "bookingReferenceId": "text",
  "expiresInMinutes": 1,
  "currencyCode": "text",
  "paymentTotal": 1,
  "paymentTotalLessCommission": 1,
  "taxes": [
    {
      "name": "text",
      "amount": 1
    }
  ],
  "fees": [
    {
      "name": "text",
      "amount": 1
    }
  ],
  "rooms": [],
  "licenses": [
    {
      "licenseType": "property",
      "licenseNumber": "text",
      "licenseIssueDate": "text"
    }
  ],
  "cancellationPolicy": {
    "policyType": "non-refundable",
    "freeCancellationUntilDays": 1
  }
}

Last updated

Was this helpful?