Skip to main content
GET
/
trips
List Trips
curl --request GET \
  --url https://api.example.com/trips
{
  "success": true,
  "message": "Trips retrieved",
  "data": [
    {
      "id": "trip-uuid-1",
      "passengerId": "passenger-uuid-123",
      "passengerName": "John Doe",
      "driverId": "driver-uuid-456",
      "currentStatus": "completed",
      "paymentMode": "card",
      "pickupPoint": {
        "lat": 40.7580,
        "lng": -73.9855
      },
      "pickupAddress": "Times Square, New York, NY",
      "fareEstimatedTotal": 15.50,
      "fareTotal": 17.25,
      "requestedAt": "2025-09-20T14:30:00Z",
      "completedAt": "2025-09-20T15:05:00Z",
      "createdAt": "2025-09-20T14:30:00Z",
      "updatedAt": "2025-09-20T15:05:00Z"
    },
    {
      "id": "trip-uuid-2",
      "passengerId": "passenger-uuid-789",
      "passengerName": "Jane Smith",
      "driverId": "driver-uuid-456",
      "currentStatus": "in_progress",
      "paymentMode": "cash",
      "pickupPoint": {
        "lat": 40.7614,
        "lng": -73.9776
      },
      "pickupAddress": "Grand Central Terminal, New York, NY",
      "fareEstimatedTotal": 22.00,
      "fareTotal": null,
      "requestedAt": "2025-09-20T15:15:00Z",
      "completedAt": null,
      "createdAt": "2025-09-20T15:15:00Z",
      "updatedAt": "2025-09-20T15:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false,
    "nextPage": null,
    "prevPage": null
  }
}
Retrieves a paginated list of trips with support for filtering by passenger, driver, vehicle, status, payment mode, and date ranges.
This endpoint is public and does not require authentication.

​
Query Parameters

​
Pagination

​
page
number
default:"1"
Page number (minimum: 1)
​
limit
number
default:"10"
Number of items per page (minimum: 1, maximum: 100)

​
Filters

​
passengerId
string
Filter by passenger UUID
​
driverId
string
Filter by driver UUID
​
vehicleId
string
Filter by vehicle UUID
​
status
enum
Filter by trip statusOptions: pending, assigning, accepted, arriving, in_progress, completed, cancelled, no_drivers_found
​
paymentMode
enum
Filter by payment methodOptions: cash, card, wallet
​
vehicleCategoryId
string
Filter by requested vehicle category UUID
​
serviceClassId
string
Filter by requested service class UUID

​
Date Ranges

​
requestedFrom
string
Filter trips requested from this date (ISO 8601 format)Example: 2025-09-01T00:00:00Z
​
requestedTo
string
Filter trips requested until this date (ISO 8601 format)Example: 2025-09-30T23:59:59Z
​
completedFrom
string
Filter trips completed from this date (ISO 8601 format)
​
completedTo
string
Filter trips completed until this date (ISO 8601 format)

​
Response

​
success
boolean
Indicates if the request was successful
​
message
string
Response message
​
data
array
Array of trip objects (see Get Trip for full structure)
​
meta
object
Pagination metadata
​
meta.page
number
Current page number
​
meta.limit
number
Items per page
​
meta.total
number
Total number of items
​
meta.totalPages
number
Total number of pages
​
meta.hasNext
boolean
Whether there is a next page
​
meta.hasPrev
boolean
Whether there is a previous page
​
meta.nextPage
number
Next page number (null if no next page)
​
meta.prevPage
number
Previous page number (null if no previous page)

​
Examples

​
List all trips (paginated)

curl https://api.rodando.com/trips?page=1&limit=20

​
Filter by passenger

curl https://api.rodando.com/trips?passengerId=123e4567-e89b-12d3-a456-426614174000

​
Filter by status

curl https://api.rodando.com/trips?status=completed&page=1&limit=50

​
Filter by date range

curl "https://api.rodando.com/trips?requestedFrom=2025-09-01T00:00:00Z&requestedTo=2025-09-30T23:59:59Z"

​
Multiple filters

curl "https://api.rodando.com/trips?driverId=driver-uuid-456&status=completed&paymentMode=card&page=1&limit=25"

{
  "success": true,
  "message": "Trips retrieved",
  "data": [
    {
      "id": "trip-uuid-1",
      "passengerId": "passenger-uuid-123",
      "passengerName": "John Doe",
      "driverId": "driver-uuid-456",
      "currentStatus": "completed",
      "paymentMode": "card",
      "pickupPoint": {
        "lat": 40.7580,
        "lng": -73.9855
      },
      "pickupAddress": "Times Square, New York, NY",
      "fareEstimatedTotal": 15.50,
      "fareTotal": 17.25,
      "requestedAt": "2025-09-20T14:30:00Z",
      "completedAt": "2025-09-20T15:05:00Z",
      "createdAt": "2025-09-20T14:30:00Z",
      "updatedAt": "2025-09-20T15:05:00Z"
    },
    {
      "id": "trip-uuid-2",
      "passengerId": "passenger-uuid-789",
      "passengerName": "Jane Smith",
      "driverId": "driver-uuid-456",
      "currentStatus": "in_progress",
      "paymentMode": "cash",
      "pickupPoint": {
        "lat": 40.7614,
        "lng": -73.9776
      },
      "pickupAddress": "Grand Central Terminal, New York, NY",
      "fareEstimatedTotal": 22.00,
      "fareTotal": null,
      "requestedAt": "2025-09-20T15:15:00Z",
      "completedAt": null,
      "createdAt": "2025-09-20T15:15:00Z",
      "updatedAt": "2025-09-20T15:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false,
    "nextPage": null,
    "prevPage": null
  }
}

​
Notes

  • All filters are optional and can be combined
  • Date filters use ISO 8601 format
  • Results are ordered by most recent first
  • Maximum limit is 100 items per page
  • Pagination metadata includes helper fields for navigation

Build docs developers (and LLMs) love

Get started for freeTalk to us