Push Bus Booking

curl -X POST https://heimdall.eka.io/apis/external/bookings/bus \
     -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-BUS-70002",
    "bookingAmount": 2900,
    "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"
      }
    ],
    "pnr": "BUS7788123",
    "operatorName": "KSRTC",
    "departureCity": "Bengaluru",
    "arrivalCity": "Chennai",
    "journeyDate": 1794501000000,
    "currency": "INR",
    "employeeCode": "EMP001",
    "employeeEmail": "rahul.sharma@acme.com",
    "tripId": "EXT-TRIP-1002",
    "tripItineraryId": "9c1d2e3f-4a5b-4c6d-8e7f-0a1b2c3d4e5f",
    "vendorName": "Acme Travels",
    "remark": "Booked via corporate TMC",
    "ticketPdf": "https://files.acme.com/tickets/EXT-BUS-70002.pdf",
    "invoicePdf": "https://files.acme.com/invoices/EXT-BUS-70002.pdf",
    "invoice": {
      "invoiceNo": "INV/2026/11/00871",
      "invoiceDate": 1793614500000,
      "vendorGstin": "27AAACI1234F1Z5",
      "hsn": "996411",
      "baseAmount": 2762,
      "cgst": 0,
      "sgst": 0,
      "igst": 138,
      "totalTax": 138
    },
    "gstDetails": {
      "gstNumber": "27AABCA1234B1Z9",
      "companyName": "Acme India Pvt Ltd",
      "companyAddress": "Level 5, One BKC, Mumbai 400051",
      "emailAddress": "gst@acme.com",
      "mobileNumber": "+912240001234"
    },
    "arrivalDate": 1794528000000,
    "busType": "AC Sleeper",
    "boardingPoint": "Majestic Bus Stand",
    "droppingPoint": "Koyambedu"
  }
}'

Records a bus 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.pnr	Mandatory	Bus ticket PNR.
booking.operatorName	Mandatory	Bus operator name.
booking.departureCity	Mandatory	Boarding city name (IATA codes are not accepted for bus).
booking.arrivalCity	Mandatory	Destination city name.
booking.journeyDate	Mandatory	Departure date & time. Epoch time in milliseconds (UTC).
booking.arrivalDate	Optional	Arrival date & time. Epoch time in milliseconds (UTC).
booking.busType	Optional	Bus type.
booking.boardingPoint	Optional	Boarding point. Defaults to the departure city.
booking.droppingPoint	Optional	Dropping point. Defaults to the arrival city.

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).

Push Bus Booking

Request Parameters

Headers

Request

Response