Push Hotel Booking

curl -X POST https://heimdall.eka.io/apis/external/bookings/hotel \
     -H "DICE-APP-ID: {{Company Code}}" \
     -H "X-CLIENT-ID: {{API Client ID}}" \
     -H "X-CLIENT-SECRET: {{API Client Secret}}" \
     -H "Content-Type: application/json" \
     -d '{
  "booking": {
    "transId": "EXT-HTL-60002",
    "bookingAmount": 20160,
    "bookingDate": 1793614500000,
    "passengers": [
      {
        "name": "Rahul Sharma",
        "email": "rahul.sharma@acme.com",
        "employeeCode": "EMP001",
        "mobile": "+919876543210",
        "gender": "MALE",
        "seatNo": "14C"
      },
      {
        "name": "Karan Mehta",
        "email": "karan.mehta@partner.com",
        "mobile": "+919811122233",
        "gender": "MALE",
        "seatNo": "14D"
      }
    ],
    "hotelName": "Taj MG Road",
    "city": "Bengaluru",
    "checkIn": 1794292200000,
    "checkOut": 1794547800000,
    "currency": "INR",
    "employeeCode": "EMP001",
    "employeeEmail": "rahul.sharma@acme.com",
    "tripId": "EXT-TRIP-1001",
    "tripItineraryId": "3f6a1c2e-9b7d-4e21-8c55-1a2b3c4d5e6f",
    "vendorName": "Acme Travels",
    "remark": "Booked via corporate TMC",
    "ticketPdf": "https://files.acme.com/tickets/EXT-HTL-60002.pdf",
    "invoicePdf": "https://files.acme.com/invoices/EXT-HTL-60002.pdf",
    "invoice": {
      "invoiceNo": "INV/2026/11/00871",
      "invoiceDate": 1793614500000,
      "vendorGstin": "27AAACI1234F1Z5",
      "hsn": "996425",
      "baseAmount": 18000,
      "cgst": 0,
      "sgst": 0,
      "igst": 2160,
      "totalTax": 2160
    },
    "gstDetails": {
      "gstNumber": "27AABCA1234B1Z9",
      "companyName": "Acme India Pvt Ltd",
      "companyAddress": "Level 5, One BKC, Mumbai 400051",
      "emailAddress": "gst@acme.com",
      "mobileNumber": "+912240001234"
    },
    "hotelAddress": "41/3 MG Road, Bengaluru 560001",
    "pnr": "TAJ-88213",
    "roomType": "Deluxe King",
    "mealPlan": "Breakfast included",
    "noOfRooms": 1
  }
}'

Records a hotel booking made outside Dice and links it to the employee’s trip.

Request Parameters

Param	Required	Description
booking	Mandatory	Booking details. Mandatory.
booking.transId	Mandatory	Your unique booking reference (e.g. TMC booking id). Must be unique in your company – it is used to fetch and cancel the booking.
booking.bookingAmount	Mandatory	Total amount paid for the booking. Must be greater than 0.
booking.bookingDate	Mandatory	When the booking was made. Epoch time in milliseconds (UTC).
booking.currency	Optional	ISO-4217 currency code of `bookingAmount`. Defaults to the employee’s currency.
booking.employeeCode	Conditional	Employee code of the booking owner. One of `employeeCode` or `employeeEmail` is mandatory; the code wins if both are sent.
booking.employeeEmail	Conditional	Email of the booking owner. Used when `employeeCode` is not sent.
booking.passengers[]	Mandatory	Travellers on this booking. Mandatory – at least one.
booking.passengers[].name	Mandatory	Passenger full name.
booking.passengers[].email	Mandatory	Passenger email.
booking.passengers[].employeeCode	Optional	Passenger’s employee code, if an employee.
booking.passengers[].mobile	Optional	Mobile number.
booking.passengers[].gender	Optional	Gender. Validated only for non-employee passengers. Values: `MALE`, `FEMALE`.
booking.passengers[].seatNo	Optional	Seat / berth number.
booking.tripId	Optional	Dice trip reference to attach the booking to. Optional – if omitted, Dice tries to match one of the owner’s open trips automatically.
booking.tripItineraryId	Optional	Itinerary (leg) id from Trip Details to attach the booking to. Only used together with `tripId`.
booking.vendorName	Optional	Vendor / agency name shown as the merchant. Defaults to the airline, hotel or bus operator name.
booking.remark	Optional	Free-text remark.
booking.ticketPdf	Optional	Publicly accessible URL of the ticket / voucher PDF.
booking.invoicePdf	Optional	Publicly accessible URL of the invoice PDF.
booking.invoice	Optional	Tax invoice details of the booking (for GST reporting).
booking.invoice.invoiceNo	Optional	Invoice number.
booking.invoice.invoiceDate	Optional	Invoice date. Epoch time in milliseconds (UTC).
booking.invoice.vendorGstin	Optional	Vendor / supplier GSTIN.
booking.invoice.hsn	Optional	HSN / SAC code.
booking.invoice.baseAmount	Optional	Taxable value.
booking.invoice.cgst	Optional	CGST amount.
booking.invoice.sgst	Optional	SGST amount.
booking.invoice.igst	Optional	IGST amount.
booking.invoice.totalTax	Optional	Total tax.
booking.gstDetails	Optional	GST details of the billing entity.
booking.gstDetails.gstNumber	Optional	Company GSTIN used for the booking.
booking.gstDetails.companyName	Optional	Registered company name.
booking.gstDetails.companyAddress	Optional	Registered address.
booking.gstDetails.emailAddress	Optional	GST contact email.
booking.gstDetails.mobileNumber	Optional	GST contact number.
booking.hotelName	Mandatory	Hotel name.
booking.city	Mandatory	City name of the hotel (must match the Dice city master).
booking.checkIn	Mandatory	Check-in date & time. Epoch time in milliseconds (UTC).
booking.checkOut	Mandatory	Check-out date & time. Must be after `checkIn`. Epoch time in milliseconds (UTC).
booking.hotelAddress	Optional	Hotel address.
booking.pnr	Optional	Hotel confirmation number.
booking.roomType	Optional	Room type.
booking.mealPlan	Optional	Meal plan.
booking.noOfRooms	Optional	Number of rooms. Defaults to 1.

Request

Request body. All booking fields are wrapped in booking.

bookingobjectRequired

Booking details. Mandatory.

Response

successboolean

Always true on HTTP 200.

transIdstring

Your booking reference.

transactionIdlong

Internal Dice transaction id.

taggedboolean

true when the booking was attached to a trip.

tripIdstringOptional

Trip the booking was attached to (absent when not attached).

tripItineraryIdstringOptional

Itinerary leg the booking was attached to (absent when only the trip matched).