Get Booking Details

curl https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001 \
     -H "DICE-APP-ID: {{Company Code}}" \
     -H "X-CLIENT-ID: {{API Client ID}}" \
     -H "X-CLIENT-SECRET: {{API Client Secret}}"

{
  "success": true,
  "transId": "EXT-FLT-50001",
  "transactionId": 7712093,
  "service": "Flight",
  "amount": 6540,
  "currency": "INR",
  "bookingStatus": "BOOKED",
  "expenseStatus": 3,
  "bookingDate": 1793614500000,
  "tripId": "EXT-TRIP-1001",
  "tripItineraryId": "3f6a1c2e-9b7d-4e21-8c55-1a2b3c4d5e6f",
  "fields": {
    "airline": "IndiGo",
    "bookingDate": "1793614500000",
    "departure.nano": "1794274200000",
    "flightNumber": "6E 5321",
    "journeyType": "ONE_WAY",
    "passengerNames": "Rahul Sharma",
    "pnr": "X7K9QP",
    "source": "EXTERNAL_API"
  },
  "files": [
    {
      "Id": "a1b2c3d4-e5f6-4711-8899-aabbccddeeff",
      "type": "OTHER",
      "title": "Ticket",
      "path": "https://files.acme.com/tickets/EXT-FLT-50001.pdf"
    }
  ],
  "ticket": {
    "airline": "IndiGo",
    "bookingId": "EXT-FLT-50001",
    "bookingStatus": "BOOKED",
    "destination": "BLR",
    "journeyType": "ONE_WAY",
    "origin": "BOM",
    "plugin": "EXTERNAL_API",
    "tripId": "EXT-TRIP-1001"
  }
}

Returns a booking pushed through the Booking APIs, including its status, trip link, captured attributes, attachments and ticket details. Only bookings created through these APIs can be fetched (403 otherwise).

Request Parameters

Param	Required	Description
transId	Mandatory	Your booking reference used at creation.

Path parameters

transIdstringRequired

Your booking reference used at creation.

Response

successbooleanOptional

Always true on HTTP 200.

transIdstringOptional

Your booking reference.

transactionIdlongOptional

Internal Dice transaction id.

serviceenumOptional

Booking type.

Allowed values:

amountdoubleOptional

Booking amount.

currencystringOptional

Currency.

bookingStatusenumOptional

Booking status.

Allowed values:

expenseStatuslongOptional

Expense status code: 3 = booked / active, 7 = cancelled.

bookingDatelongOptional

Booking date. Epoch time in milliseconds (UTC).

tripIdstringOptional

Attached trip.

tripItineraryIdstringOptional

Attached itinerary leg.

fieldsmap from strings to stringsOptional

All captured booking attributes as key/value strings (PNR, airline, invoice fields, cancellation info, …).

fileslist of objectsOptional

Ticket / invoice attachments.

ticketobjectOptional

Structured ticket (flight / hotel / bus) as stored in Dice. Shape depends on service.