Search Trips

Retrieve trips for the authenticated TRUXX HUB account.

Use this endpoint to search trips created under the authenticated account. You can filter by mobile number, trip ID, vehicle type, and date range, then page through the results.

Review create trip

EndpointGET

Path/api/Trips

Test base URLhttps://hub-sandbox-api.truxx.ae

Live base URLhttps://hub-api.truxx.ae

Authenticationx-api-key required

Request example

This endpoint accepts query parameters. All filters are optional. If no filters are provided, trips are returned for the authenticated account using the default pagination.

curl --location 'https://hub-sandbox-api.truxx.ae/api/Trips?mobileNumber=541112233&pageNumber=1&pageSize=20' \
--header 'Content-Type: application/json' \
--header 'x-api-key: truxx_sk_test_25d003e5789c483ab47793ad8cc3704f'

Query parameters

tripIdOptional. Retrieve a specific trip by its identifier.

mobileNumberOptional. Filter trips by customer mobile number.

vehicleTypeIdOptional. Filter by the selected vehicle type.

fromDateOptional. Filter trips starting from this date.

toDateOptional. Filter trips up to this date.

pageNumberOptional. Page index. Default is 1.

pageSizeOptional. Number of trips per page. Default is 100.

Response example

A successful response returns a paginated list of trips and includes pagination metadata.

{
  "success": true,
  "code": 200,
  "message": "OK",
  "data": {
    "trips": [
      {
        "TripID": 23220,
        "CustomerName": "John Doe",
        "CustomerPhoneCode": "971",
        "CustomerMobileNumber": "541112233",
        "DriverName": null,
        "VehicleTypeID": 1,
        "VehicleType": "Pickup Truck",
        "fromLat": 23.004475,
        "fromLng": 53.350864,
        "fromAddress": "2932+Q8 Arada - Abu Dhabi - United Arab Emirates",
        "fromAreaName": "Arada",
        "toAddress": "X49P+FW Ras Al-Khaimah - Ras Al Khaimah - United Arab Emirates",
        "toAreaName": "Ras Al-Khaimah",
        "toLat": 25.968739,
        "toLng": 56.137327,
        "StatusCode": 4,
        "StatusName": "Scheduled trip",
        "TripDate": "2026-03-22T22:48:00",
        "TripFare": 1402.7,
        "Invoice": "https://public.truxx.ae/Home?pdf=invoice&id=23220&env=test&type=client",
        "Receipt": "https://public.truxx.ae/Home?pdf=receipt&id=23220&env=test&type=client",
        "CreditNote": ""
      },
      {
        "TripID": 23217,
        "CustomerName": "John Doe",
        "CustomerPhoneCode": "971",
        "CustomerMobileNumber": "541112233",
        "DriverName": "Sherbat Rustam",
        "VehicleTypeID": 1,
        "VehicleType": "Pickup Truck",
        "StatusCode": -2,
        "StatusName": "Cancelled",
        "TripDate": "2026-03-16T22:48:00",
        "TripFare": 1403.5,
        "Invoice": "https://public.truxx.ae/Home?pdf=invoice&id=23217&env=test&type=client",
        "Receipt": "https://public.truxx.ae/Home?pdf=receipt&id=23217&env=test&type=client",
        "CreditNote": "https://public.truxx.ae/Home?pdf=credit-note&id=23217&env=test&type=client"
      }
    ],
    "pageNumber": 1,
    "pageSize": 20,
    "totalPages": 2,
    "totalCount": 24
  }
}

Trip fields

TripID, StatusCode, and StatusName identify the trip and its current state
CustomerName, CustomerPhoneCode, and CustomerMobileNumber describe the customer
DriverName, DriverPhoneCode, and DriverMobileNumber are included when a driver is assigned
VehicleTypeID, VehicleType, and VehicleIcon describe the vehicle
fromAddress, fromAreaName, toAddress, and toAreaName describe the route
TripDate and TripFare show scheduling and pricing
Invoice, Receipt, and CreditNote provide available document links

Pagination

pageNumberThe current response page.

pageSizeThe number of trips returned per page.

totalPagesThe total number of result pages available.

totalCountThe total number of matching trips across all pages.