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

application/json

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

400

Invalid request

application/json

401

Unauthorized

application/json

404

The specified resource was not found

application/json

500

Unexpected error occurred

application/json

post

/properties/{uuid}/reservations

HTTPcURLJavaScriptPython

POST /properties/{uuid}/reservations HTTP/1.1
x-sm-api-id: text
x-sm-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 162

{
  "checkin": "2026-02-02",
  "checkout": "2026-02-02",
  "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
  }
}

If using a Virtual Credit Card you must adhere to the following rules:

• VCC Activation Date:

  • Must be on or before the last acceptable cancellation date

  • If the reservation is non refundable, must be on or before the booking date

  • Note: The last acceptable cancellation date is calculated by CheckinDate minus freeCancellationUntilDays

• VCC Deactivation Date:

  • Must be at least 7 days after checkout date