Skip to main content
POST
/
rates
/
book
2. Complete a booking
curl --request POST \
  --url https://book.liteapi.travel/v3.0/rates/book \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "prebookId": "len80MPr_",
  "holder": {
    "firstName": "Steve",
    "lastName": "Doe",
    "email": "[email protected]",
    "phone": "0200923695"
  },
  "guests": [
    {
      "occupancyNumber": 1,
      "remarks": "quiet room please",
      "firstName": "Sunny",
      "lastName": "Mars",
      "email": "[email protected]",
      "phone": "0200923695"
    },
    {
      "occupancyNumber": 2,
      "remarks": "non smokong room please",
      "firstName": "James",
      "lastName": "Smith",
      "email": "[email protected]",
      "phone": "0343108276"
    }
  ],
  "metadata": {
    "ip": "203.112.45.67",
    "country": "FR",
    "language": "fr-FR",
    "platform": "Windows",
    "device_id": "device-abc-789",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
    "utm_medium": "organic",
    "utm_source": "bing",
    "utm_campaign": "spring_2025"
  },
  "guestPayment": {
    "method": "CREDIT_CARD",
    "phone": "0200923695",
    "payee_last_name": "john",
    "payee_first_name": "doe",
    "last_4_digits": "1111",
    "address": {
      "city": "New York",
      "address": "123 Main Street",
      "country": "US",
      "postal_code": "10001"
    }
  },
  "payment": {
    "method": "TRANSACTION_ID",
    "transactionId": "tr_ct_ELlwT7nqeZCKsxZq1Vr"
  }
}
'
{
  "data": {
    "bookingId": "ABC123",
    "clientReference": "REF123",
    "supplierBookingId": "SUP123",
    "supplierBookingName": "nuitee",
    "supplier": "nuitee",
    "supplierId": 2,
    "status": "CONFIRMED",
    "hotelConfirmationCode": "HOTEL123",
    "checkin": "2025-01-01",
    "checkout": "2025-01-02",
    "hotel": {
      "hotelId": "lp1897",
      "name": "Sample Hotel"
    },
    "bookedRooms": [
      {
        "roomType": {
          "roomTypeId": "RT123",
          "name": "Standard Room"
        },
        "boardType": "RO",
        "boardName": "Room Only",
        "adults": 2,
        "children": 0,
        "rate": {
          "rateId": "RATE123",
          "retailRate": {
            "total": {
              "amount": 100,
              "currency": "USD"
            }
          },
          "cancellationPolicies": {
            "cancelPolicyInfos": [
              {
                "cancelTime": "2025-01-01 00:00:00",
                "amount": 100,
                "type": "amount",
                "timezone": "GMT",
                "currency": "USD"
              }
            ],
            "hotelRemarks": [],
            "refundableTag": "RFN"
          },
          "maxOccupancy": 2,
          "remarks": "Standard rate"
        },
        "firstName": "John",
        "lastName": "Doe",
        "childrenAges": [],
        "board": "Room Only",
        "boardCode": "RO",
        "room_id": "RM123",
        "occupancy_number": 1,
        "amount": 100,
        "currency": "USD",
        "children_count": 0,
        "remarks": "High floor preferred",
        "guests": [
          {
            "firstName": "John",
            "lastName": "Doe",
            "email": "[email protected]",
            "phone": "+1234567890",
            "remarks": "High floor preferred",
            "occupancyNumber": 1
          }
        ],
        "mappedRoomId": 184936
      }
    ],
    "holder": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "[email protected]",
      "phone": "+1234567890"
    },
    "createdAt": "2025-01-01T00:00:00Z",
    "updatedAt": "2025-01-01T00:00:00Z",
    "cancellationPolicies": {
      "cancelPolicyInfos": [
        {
          "cancelTime": "2025-01-01 00:00:00",
          "amount": 100,
          "type": "amount",
          "timezone": "GMT",
          "currency": "USD"
        }
      ],
      "hotelRemarks": [],
      "refundableTag": "RFN"
    },
    "price": 100,
    "commission": 10,
    "currency": "USD",
    "guestId": 1,
    "trackingId": "TRACK123",
    "prebookId": "PRE123",
    "sellingPrice": "100",
    "exchangeRate": 1,
    "exchangeRateUsd": 1,
    "tag": "RFN",
    "lastFreeCancellationDate": "2025-01-01T00:00:00Z",
    "apiCommission": 5,
    "userId": 1,
    "nationality": "US",
    "loyaltyGuestId": 1,
    "cancelledAt": null,
    "refundedAt": null,
    "cancelledBy": null,
    "suggestedSellingPrice": {
      "amount": 185.7,
      "currency": "USD",
      "source": ""
    },
    "remarks": "<ul><li>Free breakfast</li><li>Free WiFi</li></ul>",
    "addonsTotalAmount": 8313.73,
    "addons": [
      {
        "addon": "uber",
        "value": 50,
        "currency": "USD",
        "originalValue": 50,
        "originalCurrency": "USD",
        "expiryDate": "2025-11-19",
        "addonVoucherCode": "https://r.uber.com/rjuwpo5UUau",
        "addonVoucherId": 1300,
        "status": "SUCCESS"
      }
    ],
    "goodwillPayment": {
      "amount": 25.5,
      "currency": "USD",
      "description": "Example description"
    }
  },
  "guestLevel": 0,
  "sandbox": true
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
timeout
integer

Body

application/json
​
prebookId
string
required

This identifier from the pre-booking step is used to confirm a booking rate

​
holder
object
required

Information on the person responsible for making the payment. This may not necessarily be the traveler

​
guests
object[]
required

This represents a list of all individuals included in the hotel reservation

​
payment
object
required

Specifies the payment method for completing the booking

​
clientReference
string

An optional client-defined reference ID acts as an idempotency key to prevent duplicate bookings

​
metadata
object

Encapsulates essential metadata for fraud detection and compliance, including IP, location, language, device details, and marketing parameters.

​
guestPayment
object

The payment method used for the transaction. This determines where the money for the booking comes from

Response

Successful response

​
data
object
​
guestLevel
integer

The guest's loyalty or membership level, if applicable.

​
sandbox
boolean

Indicates whether this booking is in a test/sandbox environment (true/false).