Skip to main content
POST
/
rates
/
prebook
1. Create a checkout session (PREBOOK)
curl --request POST \
  --url https://book.liteapi.travel/v3.0/rates/prebook \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "offerId": "GE5ESNBSIZKVEQ2OJRFEURSPKRFVUR2OIRKVGVCLKVEVERCVKNLUWRKJGVDVKVKVGJEESRK2KVHVES2PJNFE4RKPK5JVIS2SI5KTIV2TKRETKQKUI5JEGRSKLJFEMTKSGJNEOSSFIZJVIS2LJFJEIVKTK5FUKSKWJBCUKVKLJFEVMTKVJFIVUWCJJJFFKT2RJMZESUSFKUZFCUZSJE2UCVSVK5BVUTCKI5CTMVCCKZFE4TCFJ5HDERCLLJDFKNCOKNDUUTSLKRCVES2RJNDE2VSLKEZE4SKOINCU2TSDGJEVMQSVGJJTERKJGVBVMU2XINNEUVSKIZDVGQ2CJRFE2RSTKZJUWS2OIZLFKVCLJFEVKM2VIVKVGSCHKJGVMSKUGJIESSSMIVIVCSZSJNJEGVJUK5JTESSCIFKEOVSLLJGEUQ2GI5KFGUSLJJFUKR2UJNBUWNKEKVFVOS2FJFHEKVSVKVJUQSSFLJKUOTKTJZFEUSKVJ5LUWWSLKJAVKMSUIJKUUTSGIVEVESSVI42UERSHKIZEETCKINCVGVCLINGEMRCVKNHEGVKJJZDVKRKVJNEESSJTIVEVCWSYJFFE2RKPKFFFGSKSINKTEU2TIVFE4RSFKFKTESCLKZFFKT2TKNNEWSSLIVFVIS2DJNHEIVSDKYZFKSKGJBDEKVCTJBEUKWSVI5IUWTSKJJEVKUKTJNNESUSBLBMU4QSRJBAVQRCJJUZTIUCSJJCTMOZSHJETIMSGKVJEGTSMJJFEMT2UJNNEOTSEKVJVIS2VJFJEIVKTK5FUKSJVI5KVKVJSJBEUKWSVJ5JEWT2LJJHEKT2XKNKEWUSHKU2FOU2UJE2UCVCHKJBUMSS2JJDE2URSLJDUURKGKNKEWU2JKJCFKU2XJNCUSVSIIVCVKS2JJFLE2VKJKFNFQSKKJJKU6UKLGJEVERKVGJIVGMSJGVAVMVKXINNEYSSHIU3FIQSWJJHEYRKPJYZEIS22IZKTITSTI5FE4S2UIVJEWUKLIZGVMS2RGJHESTSDIVGU4QZSJFLEEVJSKMZEKSJVINLFGV2DLJFFMSSGI5JUGQSMJJGUMU2WKNFUWTSGKZKVIS2JJFKTGVKFKVJUQR2SJVLESVBSKBEUUTCFKFIUWMSLKJBVKNCXKMZEUQSBKRDVMS22JRFEGRSHKRJVES2KJNCUOVCLINFTKRCVJNLUWRKJJZCVMVKVKNEEURK2KVDU2U2OJJFESVKPK5FVUS2SIFKTEVCCKVFE4RSFJFJEUVKHGVBEMR2SGJBEYSSDIVJVIS2DJRDEIVKTJZBVKSKOI5KUKVKLJBEUSM2FJFIVUWCJJJGUKT2RJJJUSUSDKUZFGU2FJJHEMRKRKUZEQS2WJJKU6U2TLJFUUS2FJNKEWQ2LJZCFMQ2WGJKUSRSIIZCVIU2IJFCVUVKHKFFU4SSKJFKVCU2LLJEVEQKYLFHEEUKIIFMEISKNGM2FAUSKIU3HYMJQGYYTAML4GJ6GY4BRHFSTONL4GEWTWMRNGEYXYVKTIR6FKU34GIYDENBNGA4S2MBRPQZDAMRUFUYDSLJQGN6A",
  "usePaymentSdk": true,
  "voucherCode": "example-voucher-1234",
  "addons": [
    {
      "addon": "uber",
      "value": 50,
      "currency": "USD"
    },
    {
      "addon": "uber",
      "value": 70,
      "currency": "USD"
    },
    {
      "addon": "esimply",
      "value": 30,
      "currency": "USD",
      "addonDetails": {
        "package_id": 1,
        "destination_code": "US",
        "start_date": "2025-12-05",
        "end_date": "2025-12-10"
      }
    }
  ],
  "bedTypeIds": [
    1,
    2
  ]
}
'
{
  "data": {
    "prebookId": "zzWkJcdgk",
    "offerId": "GE5ESNBSIZKVMQ2QJJNEERSPKIZEMR2OIRKVOVCTKNFVMRCWKNLUWVKKGVDVMRKWGJEEWRSOIVEVCS2PJNJEEVKPK5FFKS2SI5LFKU2TLBETIMSGKVJEGQSKLJHEMR2SGIZEWUSDIUZFOU2TJM2UOVSFJZJUKSKOIVLFKVJSJBEUMTSFJFJTETSJJJFVKT2RJNNEYQSNKUZFKU2SJE2UKVCFKZBUESS2IJDEGURSJNDVURCVK5GTEVCHGVDFMTKTKNMUYRSMIVLVMQ2RJNFEMVSNKIZFGSKRGJCU6U2TIJFVEQKWINGVUVKJGVCVMVKSINJEUVK2KREVGMSWJRFEIRJSKYZEKS2OJFDEGV2LKVFDKSCFIVKUWSCHKFNEKSKRJNHESSSNIVHVCSSTJFJECVJUKEZESSS2JJDEWUSLLJFEMTSGJ5JDESSHKJFUKV2TJMZEWVSEKZFU2MSUI5FEQRSFKUZESSKVLJDFCV2LKZFU4RCVKVLVEV2JKJBVKMSRKNKESNKLKZJVEQ2IJJLE4RSDKIZEETCKINCUGVCLIVDVERCVJVHFGRSJGQZVKR2VGJEESVSNKZEVKS2OJFITERKPKJFFGS2SJBKTEV2TLFEVMSCFKVJEUV2KIVNEMR2TJMZEUQSCKVHVIS2TJNDEIVKTJVJVIR2KI5KUKVSDI5FVMTSGJFIUWSSJJJEVKT2TJJLESUSBKUZFCTBUI5CTGRCHJRJFOR22GZCEKTKCKNDVKV2UIFGVUTSHJVMUGQKNIJJUQSKZIRAU6USRI5BDMRSFKRMXYNRSHE2XYMT4NRYDCOBZG56DELL4KVJUI7CVKN6DEMBSGUWTANBNGAYXYMRQGI2S2MBUFUYDE7D4GQXDAMA",
    "hotelId": "lp1897",
    "checkin": "2025-12-05",
    "checkout": "2025-12-10",
    "currency": "USD",
    "termsAndConditions": "",
    "roomTypes": [
      {
        "rates": [
          {
            "rateId": "I42FUVCPJZBFOR2FGNDUWTSSKVDVSWKUJ5GVEV2HKFNEIQKOKRBUOWJUKRGVUSSXI42FURCBJZNFGR22KRCE2WSSK5GVENSEINEVUU2HIFNEIS2NIJKUOQKZLBMU2USRI5ETEVCBJZBFCR2KGZDUWM2TG5FVMSSYLFLEWVCQKJFVMR2SIQ2EOSSBKRAVCMZUI5EVURCRJUZTIS2VLJDE2V2EKNIFCWKUJ5HEEUKHGQZEIQKNIJMEOQJSIRAU4Q2IJZJFKRKZJFNFOR2JGRKEWSK2KVDVKM2TGJHFEU2IIUZFQWKVKNDUUWRWIRCU2QSTI5KVSRCHJVNFCR2BLJCECTKEGRDUMNSFI43UGU2HIVMVIUKNIQ2EORJSKRHU2WSYIVHEURJWJEZFGSK2JBBUOTKSKFDUSMSTGJGUEVCGKVNFIQKJIJIUOSJVIRAU2QL4GE3DGLRWGZ6DEMBSGUWTAMZNGMYCAMBSHIYDAORQGB6FETY",
            "occupancyNumber": 1,
            "name": "Standard King Room - Room only",
            "maxOccupancy": 2,
            "adultCount": 2,
            "childCount": 0,
            "childrenAges": [],
            "boardType": "RO",
            "boardName": "Room Only",
            "remarks": "<br/><br/>A Resort Fee totaling USD43.61 will be charged for the stay. The Manhattan at Times Square Hotel has a mandatory Facilities Fee of $40.16 per room per night provides guests with the following inclusive services, amenities and added value offerings: \n All local, long distance and international phone calls \n Premium high-speed wireless internet access for unlimited devices \n An eco-friendly, collapsible 16 oz. water bottle to use at the hotel?s water filtration stations \n Unlimited use of our Business Center \n Unlimited use of our 24/7 Fitness Center with treadmills, bikes, elliptical machines and free weights \n*The Facilities Fee does not include service gratuity . Hotel Check In Policy: Major credit card required at check-in for deposit and incidentals. Any additional fees such as parking, pet fees, etc. are solely at the discretion of the hotel, are subject to change at any point and should be paid directly by the guest.. Minimum adult age at check in is 21 years.<br/>",
            "priceType": "commission",
            "commission": [
              {
                "amount": 6.28,
                "currency": "USD"
              }
            ],
            "retailRate": {
              "total": [
                {
                  "amount": 163.66,
                  "currency": "USD"
                }
              ],
              "suggestedSellingPrice": [
                {
                  "amount": 185.7,
                  "currency": "USD",
                  "source": ""
                }
              ],
              "initialPrice": null,
              "taxesAndFees": [
                {
                  "included": true,
                  "description": "NYC Javits Center Fee",
                  "amount": 1.62,
                  "currency": "USD"
                },
                {
                  "included": true,
                  "description": "NYC Occupancy Tax",
                  "amount": 2.16,
                  "currency": "USD"
                },
                {
                  "included": true,
                  "description": "NY State Tax",
                  "amount": 11.88,
                  "currency": "USD"
                },
                {
                  "included": true,
                  "description": "NY City Tax",
                  "amount": 7.87,
                  "currency": "USD"
                },
                {
                  "included": false,
                  "description": "Facility Fee",
                  "amount": 43.61,
                  "currency": "USD"
                }
              ]
            },
            "cancellationPolicies": {
              "cancelPolicyInfos": [
                {
                  "cancelTime": "2025-03-30 02:00:00",
                  "amount": 163.66,
                  "currency": "USD",
                  "type": "amount",
                  "timezone": "GMT"
                }
              ],
              "hotelRemarks": [],
              "refundableTag": "RFN"
            },
            "paymentTypes": [
              "NUITEE_PAY",
              "PROPERTY_PAY"
            ],
            "perks": []
          }
        ]
      }
    ],
    "suggestedSellingPrice": {
      "amount": 185.7,
      "currency": "USD",
      "source": "expedia.com"
    },
    "isPackageRate": null,
    "commission": 6.28,
    "addonsTotalAmount": 70,
    "price": 213.66,
    "priceType": "commission",
    "priceDifferencePercent": 0,
    "cancellationChanged": false,
    "boardChanged": false,
    "supplier": "nuitee",
    "supplierId": 2,
    "transactionId": "tr_ct_NjePtG_-HHUDCeQ_LrTOS",
    "secretKey": "pi_3QxSJ8A4FXPoRk9Y14cv6f1G_secret_psA870CD4S17fSh58skN1TWaG",
    "voucherCode": "createvoucher83",
    "voucherTotalAmount": 20,
    "addonsRequest": [
      {
        "addon": "uber",
        "value": 70,
        "currency": "USD"
      }
    ],
    "creditLine": {
      "remainingCredit": 1000,
      "currency": "USD"
    }
  },
  "guestLevel": 0
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
timeout
integer
​
includeCreditBalance
boolean

Optional flag to include credit line information in the response. When set to true, credit line details will be returned if the user has a credit line available. This can also be provided in the request body as includeCreditBalance.

Body

application/json
​
offerId
string
required

The unique identifier of the selected offer from the search results.

​
usePaymentSdk
boolean
required

Specifies whether the fields needed to call the payment processing SDK are returned. Set to true if using the SDK for payment processing.

​
voucherCode
string

An optional voucher code to apply discounts to the booking. The vouchers API allows creation of these discounts

​
addons
object[]

A list of additional services or extras that can be added to the booking. For example, adding an Uber voucher or an esim card. The final booking amount is the sum of the offer's total price and the cost of any addons. Each addon's price is added individually to reflect all extras in the billed total.

​
bedTypeIds
integer[]

An optional array of bed type IDs to specify preferred bed configurations for the rooms being booked. The availability of specific bed types depends on the hotel's inventory.

​
includeCreditBalance
boolean

Optional flag to include credit line information in the response. When set to true, credit line details will be returned if the user has a credit line available.

Example:

false

Response

OK

​
data
object
​
guestLevel
integer

Used with loyalty programs to determine the guests level of cost reduction.