> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://open-api-docs.dice.tech/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://open-api-docs.dice.tech/_mcp/server.

# Get Booking Details

GET https://heimdall.eka.io/apis/external/bookings/details/{transId}

### Get Booking Details

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

Reference: https://open-api-docs.dice.tech/dice-standardized-ap-is-v-2-copy/booking/get-booking-details

## Servers

- `https://heimdall.eka.io` (https://heimdall.eka.io, default)
- `https://heimdall.eka.ioapis` (https://heimdall.eka.ioapis)

## Request

### Path parameters

- `transId` (string, required) — Your booking reference used at creation.

### Headers

- `DICE-APP-ID` (string, optional) — Company Code of client
- `X-CLIENT-ID` (string, optional) — API Client ID
- `X-CLIENT-SECRET` (string, optional) — API Client Secret

## Response

### 200

OK

- `success` (boolean, optional) — Always `true` on HTTP 200.
- `transId` (string, optional) — Your booking reference.
- `transactionId` (long, optional) — Internal Dice transaction id.
- `service` (enum, optional) — Booking type.
  - Allowed values: `Flight`, `Hotel`, `Bus`
- `amount` (double, optional) — Booking amount.
- `currency` (string, optional) — Currency.
- `bookingStatus` (enum, optional) — Booking status.
  - Allowed values: `BOOKED`, `CANCELLED`
- `expenseStatus` (long, optional) — Expense status code: `3` = booked / active, `7` = cancelled.
- `bookingDate` (long, optional) — Booking date. Epoch time in **milliseconds** (UTC).
- `tripId` (string, optional) — Attached trip.
- `tripItineraryId` (string, optional) — Attached itinerary leg.
- `fields` (map from string to string, optional) — All captured booking attributes as key/value strings (PNR, airline, invoice fields, cancellation info, …).
- `files` (list of ApisExternalBookingsDetailsTransIdGetResponsesContentApplicationJsonSchemaFilesItems, optional) — Ticket / invoice attachments.
- `ticket` (ApisExternalBookingsDetailsTransIdGetResponsesContentApplicationJsonSchemaTicket, optional) — Structured ticket (flight / hotel / bus) as stored in Dice. Shape depends on `service`.

## Types

### ApisExternalBookingsDetailsTransIdGetResponsesContentApplicationJsonSchemaFilesItems

Attached file.

- `Id` (string, optional) — File id (note the capital `I`).
- `type` (string, optional) — File type.
- `title` (enum, optional) — `Ticket` or `Invoice`.
  - Allowed values: `Ticket`, `Invoice`
- `path` (string, optional) — File URL.

### ApisExternalBookingsDetailsTransIdGetResponsesContentApplicationJsonSchemaTicket

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

## Examples

**Response**

```json
{
  "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"
  }
}
```

**SDK Code**

```python
import requests

url = "https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001"

headers = {
    "DICE-APP-ID": "{{Company Code}}",
    "X-CLIENT-ID": "{{API Client ID}}",
    "X-CLIENT-SECRET": "{{API Client Secret}}"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001';
const options = {
  method: 'GET',
  headers: {
    'DICE-APP-ID': '{{Company Code}}',
    'X-CLIENT-ID': '{{API Client ID}}',
    'X-CLIENT-SECRET': '{{API Client Secret}}'
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("DICE-APP-ID", "{{Company Code}}")
	req.Header.Add("X-CLIENT-ID", "{{API Client ID}}")
	req.Header.Add("X-CLIENT-SECRET", "{{API Client Secret}}")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["DICE-APP-ID"] = '{{Company Code}}'
request["X-CLIENT-ID"] = '{{API Client ID}}'
request["X-CLIENT-SECRET"] = '{{API Client Secret}}'

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001")
  .header("DICE-APP-ID", "{{Company Code}}")
  .header("X-CLIENT-ID", "{{API Client ID}}")
  .header("X-CLIENT-SECRET", "{{API Client Secret}}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001', [
  'headers' => [
    'DICE-APP-ID' => '{{Company Code}}',
    'X-CLIENT-ID' => '{{API Client ID}}',
    'X-CLIENT-SECRET' => '{{API Client Secret}}',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001");
var request = new RestRequest(Method.GET);
request.AddHeader("DICE-APP-ID", "{{Company Code}}");
request.AddHeader("X-CLIENT-ID", "{{API Client ID}}");
request.AddHeader("X-CLIENT-SECRET", "{{API Client Secret}}");
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "DICE-APP-ID": "{{Company Code}}",
  "X-CLIENT-ID": "{{API Client ID}}",
  "X-CLIENT-SECRET": "{{API Client Secret}}"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://heimdall.eka.io/apis/external/bookings/details/EXT-FLT-50001")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```