Skip to main content
GET
/
trips
/
{id}
Get Trip
curl --request GET \
  --url https://api.example.com/trips/{id}
{
  "success": true,
  "message": "Trip retrieved successfully",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "passengerId": "passenger-uuid-123",
    "passengerName": "John Doe",
    "passengerPhone": "+1234567890",
    "driverId": "driver-uuid-456",
    "vehicleId": "vehicle-uuid-789",
    "orderId": null,
    "requestedVehicleCategoryId": "cat-uuid-auto",
    "requestedVehicleCategoryName": "Auto",
    "requestedServiceClassId": "class-uuid-standard",
    "requestedServiceClassName": "Standard",
    "currentStatus": "in_progress",
    "paymentMode": "card",
    "pickupPoint": {
      "lat": 40.7580,
      "lng": -73.9855
    },
    "pickupAddress": "Times Square, New York, NY",
    "stops": [
      {
        "seq": 1,
        "point": {
          "lat": 40.7614,
          "lng": -73.9776
        },
        "address": "Grand Central Terminal, New York, NY",
        "notes": "Wait at main entrance",
        "plannedArrivalAt": null,
        "arrivedAt": null,
        "completedAt": null
      }
    ],
    "fareEstimatedTotal": 15.50,
    "fareTotal": null,
    "fareFinalCurrency": "USD",
    "fareDistanceKm": null,
    "fareDurationMin": null,
    "fareSurgeMultiplier": 1.0,
    "fareBreakdown": null,
    "requestedAt": "2025-09-20T14:30:00Z",
    "acceptedAt": "2025-09-20T14:32:00Z",
    "pickupEtaAt": "2025-09-20T14:42:00Z",
    "arrivedPickupAt": "2025-09-20T14:41:00Z",
    "startedAt": "2025-09-20T14:45:00Z",
    "completedAt": null,
    "canceledAt": null,
    "createdAt": "2025-09-20T14:30:00Z",
    "updatedAt": "2025-09-20T14:45:00Z"
  }
}
Retrieves complete details for a trip by its unique identifier, including passenger information, driver assignment, stops, fare breakdown, and status timestamps.

​
Path Parameters

​
id
string
required
UUID of the trip to retrieve

​
Response

​
success
boolean
Indicates if the request was successful
​
message
string
Response message
​
data
object
Complete trip details
​
data.id
string
Unique trip identifier (UUID)
​
data.passengerId
string
UUID of the passenger
​
data.passengerName
string
Full name of the passenger
​
data.passengerPhone
string
Phone number of the passenger
​
data.driverId
string
UUID of the assigned driver (null if not yet assigned)
​
data.vehicleId
string
UUID of the assigned vehicle (null if not yet assigned)
​
data.orderId
string
UUID of the payment order (if applicable)
​
data.requestedVehicleCategoryId
string
UUID of requested vehicle category
​
data.requestedVehicleCategoryName
string
Name of requested vehicle category (e.g., Auto, Moto, Van)
​
data.requestedServiceClassId
string
UUID of requested service class
​
data.requestedServiceClassName
string
Name of requested service class (e.g., Standard, Premium)
​
data.currentStatus
string
Current trip status: pending, assigning, accepted, arriving, in_progress, completed, cancelled, or no_drivers_found
​
data.paymentMode
string
Payment method: cash, card, or wallet
​
data.pickupPoint
object
Pickup location coordinates
​
data.pickupPoint.lat
number
Latitude
​
data.pickupPoint.lng
number
Longitude
​
data.pickupAddress
string
Human-readable pickup address
​
data.stops
array
Array of trip stops
​
data.stops[].seq
number
Stop sequence number
​
data.stops[].point
object
Stop coordinates
​
data.stops[].point.lat
number
Latitude
​
data.stops[].point.lng
number
Longitude
​
data.stops[].address
string
Stop address
​
data.stops[].placeId
string
Place identifier
​
data.stops[].notes
string
Additional instructions
​
data.stops[].plannedArrivalAt
string
Planned arrival timestamp (ISO 8601)
​
data.stops[].arrivedAt
string
Actual arrival timestamp (ISO 8601)
​
data.stops[].completedAt
string
Completion timestamp (ISO 8601)
​
data.fareEstimatedTotal
number
Initial estimated fare
​
data.fareTotal
number
Final fare amount (set when trip is completed)
​
data.fareFinalCurrency
string
Currency code for the fare
​
data.fareDistanceKm
number
Actual distance traveled in kilometers
​
data.fareDurationMin
number
Actual trip duration in minutes
​
data.fareSurgeMultiplier
number
Surge pricing multiplier applied
​
data.fareBreakdown
object
Detailed fare calculation breakdown (see Estimate Trip for structure)
​
data.requestedAt
string
ISO 8601 timestamp when trip was requested
​
data.acceptedAt
string
ISO 8601 timestamp when driver accepted
​
data.pickupEtaAt
string
ISO 8601 timestamp for estimated pickup arrival
​
data.arrivedPickupAt
string
ISO 8601 timestamp when driver arrived at pickup
​
data.startedAt
string
ISO 8601 timestamp when trip started (passenger on board)
​
data.completedAt
string
ISO 8601 timestamp when trip was completed
​
data.canceledAt
string
ISO 8601 timestamp when trip was cancelled
​
data.createdAt
string
ISO 8601 timestamp of creation
​
data.updatedAt
string
ISO 8601 timestamp of last update

​
Example

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

{
  "success": true,
  "message": "Trip retrieved successfully",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "passengerId": "passenger-uuid-123",
    "passengerName": "John Doe",
    "passengerPhone": "+1234567890",
    "driverId": "driver-uuid-456",
    "vehicleId": "vehicle-uuid-789",
    "orderId": null,
    "requestedVehicleCategoryId": "cat-uuid-auto",
    "requestedVehicleCategoryName": "Auto",
    "requestedServiceClassId": "class-uuid-standard",
    "requestedServiceClassName": "Standard",
    "currentStatus": "in_progress",
    "paymentMode": "card",
    "pickupPoint": {
      "lat": 40.7580,
      "lng": -73.9855
    },
    "pickupAddress": "Times Square, New York, NY",
    "stops": [
      {
        "seq": 1,
        "point": {
          "lat": 40.7614,
          "lng": -73.9776
        },
        "address": "Grand Central Terminal, New York, NY",
        "notes": "Wait at main entrance",
        "plannedArrivalAt": null,
        "arrivedAt": null,
        "completedAt": null
      }
    ],
    "fareEstimatedTotal": 15.50,
    "fareTotal": null,
    "fareFinalCurrency": "USD",
    "fareDistanceKm": null,
    "fareDurationMin": null,
    "fareSurgeMultiplier": 1.0,
    "fareBreakdown": null,
    "requestedAt": "2025-09-20T14:30:00Z",
    "acceptedAt": "2025-09-20T14:32:00Z",
    "pickupEtaAt": "2025-09-20T14:42:00Z",
    "arrivedPickupAt": "2025-09-20T14:41:00Z",
    "startedAt": "2025-09-20T14:45:00Z",
    "completedAt": null,
    "canceledAt": null,
    "createdAt": "2025-09-20T14:30:00Z",
    "updatedAt": "2025-09-20T14:45:00Z"
  }
}

​
Error Responses

​
400 Bad Request

Invalid UUID format

​
404 Not Found

Trip with the specified ID does not exist

​
Passenger Active Trip

GET /trips/passengers/{passengerId}/active-trip
curl https://api.rodando.com/trips/passengers/passenger-uuid-123/active-trip
Returns the passenger’s currently active trip (any trip not in completed, cancelled, or no_drivers_found status).

​
Driver Active Trip

GET /trips/drivers/{driverId}/active-trip
curl https://api.rodando.com/trips/drivers/driver-uuid-456/active-trip
Returns the driver’s currently active trip (any trip where driver is assigned and trip is not completed or cancelled).

Build docs developers (and LLMs) love

Get started for freeTalk to us