> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grdd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Booking by Transaction ID

> Retrieve booking details using a unique transaction ID.

## Get Booking API

The **Get Booking API** allows you to retrieve the full details of a booking/reservation using its unique transaction ID. This includes trip details, passenger information, pickup and drop-off locations, vehicle type, booking status, affiliate reservation info, and any transaction errors.

***

### **Endpoint**

`GET /api/reservation/{transactionId}`

`Authorization: Bearer <your_token>`

***

### **Path Parameters**

| Parameter     | Type   | Description                                     | Required |
| ------------- | ------ | ----------------------------------------------- | -------- |
| transactionId | string | The unique transaction ID (UUID) of the booking | Yes      |

***

### **Response Fields**

| Field          | Type   | Description                                             |
| -------------- | ------ | ------------------------------------------------------- |
| transactionId  | string | The unique transaction ID (UUID)                        |
| fromConextId   | string | The GRiDD ID of the requesting company                  |
| toConextId     | string | The GRiDD ID of the receiving company                   |
| timestamp      | number | Unix timestamp of the transaction                       |
| userid         | string | The user who created the booking                        |
| sourcePlatform | string | The source platform (e.g. GRIDD)                        |
| targetPlatform | string | The target platform (e.g. LIMOANYWHERE)                 |
| sourceResNo    | string | Source reservation number                               |
| targetResNo    | string | Target reservation number (null if not yet assigned)    |
| lastStatus     | string | The last known status of the booking                    |
| submitDate     | number | Unix timestamp when the booking was submitted           |
| pickupDate     | number | Unix timestamp of the scheduled pickup                  |
| tripPacket     | object | Full trip details (locations, passengers, status, etc.) |

***

### **Trip Packet Details**

The `tripPacket` object contains the full trip information:

* **locations** — Pickup and drop-off location details including coordinates, address, and flight info
* **passengers** — Array of passenger objects with name, email, phone, and account number
* **affiliateReservation** — Affiliate booking details including requester/provider IDs and status
* **transactionErrors** — Array of any errors encountered during the transaction
* **changeLogs** — Array of status change history entries
* **account** — Account information associated with the booking

***

### **Example Request**

```bash theme={null}
curl -X GET "https://core.grdd.net/api/reservation/2e88ae81-3871-474f-ac0a-1a441eb83d0c" \
  -H "Authorization: Bearer <your_token>"
```

***

### **Example Response**

```json theme={null}
{
  "success": true,
  "data": {
    "transactionId": "2e88ae81-3871-474f-ac0a-1a441eb83d0c",
    "fromConextId": "gnettest",
    "toConextId": "latest",
    "timestamp": 1773146401820,
    "userid": "user@company",
    "sourcePlatform": "GRIDD",
    "targetPlatform": "LIMOANYWHERE",
    "sourceResNo": "1234567890",
    "targetResNo": null,
    "lastStatus": "BOOKING_REQUEST",
    "submitDate": 1773146401210,
    "pickupDate": 1773419579000,
    "tripPacket": {
      "reservationType": "REGULAR",
      "runType": "Airport",
      "reservationDate": "2026-03-10T18:40:01",
      "passengerCount": "1",
      "preferredVehicleType": "SPRINTER",
      "status": "BOOKING_REQUEST",
      "resStatus": "Pending",
      "locations": {
        "pickup": {
          "locationType": "address",
          "landmark": "123 Main Street",
          "address": "123 Main St, Anytown, CA 90000, USA",
          "city": "Anytown",
          "state": "California",
          "zipCode": "90000",
          "country": "United States"
        },
        "dropOff": {
          "locationType": "airport",
          "landmark": "Los Angeles Intl",
          "address": "LAX",
          "country": "United States",
          "flightInfo": {
            "airlineCode": "AA",
            "flightNumber": "100"
          }
        }
      },
      "passengers": [
        {
          "firstName": "John",
          "lastName": "Doe",
          "email": "john.doe@example.com",
          "phoneNumber": "+1-555-0000"
        }
      ]
    }
  }
}
```