GET /guestrides
A GET to the /guestrides endpoint allows your application to fetch an array of the guest rides your user is authorized to view. Guest rides are standalone rideshare requests initiated on behalf of a dealership's guest. Requests made to this endpoint require an authorization header using your authentication token:
curl --request GET \
--url https://api.hopdrive.com/v1/guestrides \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <your token>'
Filters
You can filter the results using the following optional query parameters.
limit - The number of results per page (default 10, max 100).
page - Which page to start with (default 0).
rooftop - A valid rooftop id that your token has access to.
from - An ISO 8601 timestamp to search from. This will search based on the guest ride's created_at. Only a lower bound is supported — there is no to parameter.
status - A guest ride lifecycle status: new, pending, booked, driver_assigned, driver_arrived, in_progress, completed, cancelled, or failed. These match the guestride.* webhook event names.
Results are ordered by created_at, newest first, then by id to break ties so
that paging through rides booked in the same instant is stable.
Guest rides that have been deleted are not returned, by this endpoint or by
GET /guestrides/:id — a deleted ride reads as
404, the same as one that never existed. Every ride you receive carries one of
the nine statuses listed above.
Each row carries the same fields as GET /guestrides/:id, including the ride object for the current provider ride, with one exception: the list does not include the charge object. Fetch a single guest ride for billing detail.
Example Request
Example Response
{
"guestrides": [
{
"id": 42,
"rooftop": 108,
"status": "completed",
"guest_name": "Jamie Guest",
"guest_phone": "+15555550123",
"pickup_address": "123 Dealer Way, Richmond, VA 23220",
"pickup_lat": 37.5407,
"pickup_lng": -77.436,
"dropoff_address": "456 Guest St, Richmond, VA 23220",
"dropoff_lat": 37.5538,
"dropoff_lng": -77.4603,
"notes": "Guest waiting at service entrance",
"reference_num": "RO-8891",
"created_at": "2026-08-01T12:00:00+00:00",
"updated_at": "2026-08-01T12:30:00+00:00",
"ride": {
"provider": "lyft",
"product_type": "lyft",
"attempt_number": 1,
"quality_rejection_reason": null,
"tracking_link": "https://ride.lyft.com/csl/abc123",
"driver_name": "Sandra",
"driver_phone": "+12265550123",
"driver_rating": 5,
"driver_photo_url": "https://.../driver.jpg",
"vehicle_year": 2018,
"vehicle_make": "GMC",
"vehicle_model": "Yukon XL",
"vehicle_color": null,
"vehicle_license_plate": "3LYF123",
"vehicle_photo_url": "https://.../vehicle.png",
"booked_at": "2026-08-01T12:01:15+00:00",
"driver_assigned_at": "2026-08-01T12:01:18+00:00",
"pickup_at": "2026-08-01T12:02:31+00:00",
"dropoff_at": "2026-08-01T12:20:49+00:00"
}
}
]
}