Skip to main content

​
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

ParameterTypeDescriptionRequired
transactionIdstringThe unique transaction ID (UUID) of the bookingYes

​
Response Fields

FieldTypeDescription
transactionIdstringThe unique transaction ID (UUID)
fromConextIdstringThe GRiDD ID of the requesting company
toConextIdstringThe GRiDD ID of the receiving company
timestampnumberUnix timestamp of the transaction
useridstringThe user who created the booking
sourcePlatformstringThe source platform (e.g. GRIDD)
targetPlatformstringThe target platform (e.g. LIMOANYWHERE)
sourceResNostringSource reservation number
targetResNostringTarget reservation number (null if not yet assigned)
lastStatusstringThe last known status of the booking
submitDatenumberUnix timestamp when the booking was submitted
pickupDatenumberUnix timestamp of the scheduled pickup
tripPacketobjectFull 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

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

​
Example Response

{
  "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"
        }
      ]
    }
  }
}