> ## 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 a booking by transaction ID

> Retrieve the details of a booking/reservation using its unique transaction ID. Returns full trip details including passenger info, locations, vehicle type, status, and any transaction errors.



## OpenAPI

````yaml /connect-api/openapi.json get /api/reservation/{transactionId}
openapi: 3.0.0
info:
  title: GNet Connect API
  version: 1.0.0
  description: API for the GNet Connect platform
servers:
  - url: https://core.grdd.dev
    description: Development server
  - url: https://core.grdd.net
    description: Production server
security: []
paths:
  /api/reservation/{transactionId}:
    get:
      tags:
        - booking
      summary: Get a booking by transaction ID
      description: >-
        Retrieve the details of a booking/reservation using its unique
        transaction ID. Returns full trip details including passenger info,
        locations, vehicle type, status, and any transaction errors.
      operationId: get_booking
      parameters:
        - name: transactionId
          in: path
          required: true
          description: The unique transaction ID (UUID) of the booking
          schema:
            type: string
            format: uuid
            example: 2e88ae81-3871-474f-ac0a-1a441eb83d0c
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      transactionId:
                        type: string
                        format: uuid
                        description: The unique transaction ID
                      fromConextId:
                        type: string
                        description: The GRiDD ID of the requesting company
                      toConextId:
                        type: string
                        description: The GRiDD ID of the receiving company
                      timestamp:
                        type: number
                        description: Unix timestamp of the transaction
                      userid:
                        type: string
                        description: The user who created the booking
                      sourcePlatform:
                        type: string
                        description: The source platform (e.g. GRIDD)
                      targetPlatform:
                        type: string
                        description: The target platform (e.g. LIMOANYWHERE)
                      sourceResNo:
                        type: string
                        description: Source reservation number
                      targetResNo:
                        type: string
                        nullable: true
                        description: Target reservation number (null if not yet assigned)
                      lastStatus:
                        type: string
                        description: The last known status of the booking
                        example: BOOKING_REQUEST
                      submitDate:
                        type: number
                        description: Unix timestamp when the booking was submitted
                      pickupDate:
                        type: number
                        description: Unix timestamp of the scheduled pickup
                      tripPacket:
                        type: object
                        description: >-
                          Full trip details including locations, passengers, and
                          status
                        properties:
                          reservationType:
                            type: string
                            example: REGULAR
                          runType:
                            type: string
                            example: Airport
                          reservationDate:
                            type: string
                            format: date-time
                          passengerCount:
                            type: string
                          preferredVehicleType:
                            type: string
                            example: SPRINTER
                          specialInstructions:
                            type: string
                          status:
                            type: string
                            example: BOOKING_REQUEST
                          resStatus:
                            type: string
                            example: Pending
                          locations:
                            type: object
                            properties:
                              pickup:
                                type: object
                                properties:
                                  locationType:
                                    type: string
                                  landmark:
                                    type: string
                                  lat:
                                    type: string
                                  lon:
                                    type: string
                                  address:
                                    type: string
                                  city:
                                    type: string
                                  state:
                                    type: string
                                  zipCode:
                                    type: string
                                  country:
                                    type: string
                                  time:
                                    type: string
                                    format: date-time
                              dropOff:
                                type: object
                                properties:
                                  locationType:
                                    type: string
                                  landmark:
                                    type: string
                                  lat:
                                    type: string
                                  lon:
                                    type: string
                                  address:
                                    type: string
                                  country:
                                    type: string
                                  flightInfo:
                                    type: object
                                    properties:
                                      airlineCode:
                                        type: string
                                      flightNumber:
                                        type: string
                          passengers:
                            type: array
                            items:
                              type: object
                              properties:
                                firstName:
                                  type: string
                                lastName:
                                  type: string
                                email:
                                  type: string
                                phoneNumber:
                                  type: string
                                accountNumber:
                                  type: string
                          affiliateReservation:
                            type: object
                            properties:
                              requesterId:
                                type: string
                              requesterResNo:
                                type: string
                              providerId:
                                type: string
                              action:
                                type: string
                              status:
                                type: string
                              notes:
                                type: string
                          transactionErrors:
                            type: array
                            items:
                              type: object
                              properties:
                                timestamp:
                                  type: string
                                  format: date-time
                                errCode:
                                  type: string
                                errDesc:
                                  type: string
                          changeLogs:
                            type: array
                            items:
                              type: object
                              properties:
                                timestamp:
                                  type: string
                                  format: date-time
                                changeSource:
                                  type: string
                                changeDesc:
                                  type: string
                          account:
                            type: object
                            properties:
                              accountNumber:
                                type: string
                              accountName:
                                type: string
                              callerName:
                                type: string
                              callerNumber:
                                type: string
        '401':
          description: Unauthorized - Invalid or missing token
        '404':
          description: Booking not found
      security:
        - bearerAuth: []
components: {}

````