Create Account
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 tripReview trip ETA
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,
        "DriverPhoneCode": null,
        "DriverMobileNumber": null,
        "PlateNumber": null,
        "VehicleTypeID": 1,
        "VehicleIcon": "https://truxx.b-cdn.net/4aacea94-9fe3-4957-9bb1-2b868855ac96.webp",
        "VehicleType": "Pickup Truck",
        "DriverLat": 23.004475,
        "DriverLng": 53.350864,
        "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",
        "DriverPhoneCode": "971",
        "DriverMobileNumber": "506001442",
        "PlateNumber": "42058",
        "VehicleTypeID": 1,
        "VehicleIcon": "https://truxx.b-cdn.net/4aacea94-9fe3-4957-9bb1-2b868855ac96.webp",
        "VehicleType": "Pickup Truck",
        "DriverLat": 23.004475,
        "DriverLng": 53.350864,
        "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": -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, DriverMobileNumber, DriverLat, and DriverLng are included when a driver is assigned
  • VehicleTypeID, VehicleType, VehicleIcon, and PlateNumber 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.