Rides
Quote a fare, request a ride, and follow it to completion. A quote returns real road distance, driving time and the final price per vehicle tier, tax included — the same figures the Ryde apps show, because they come from the same pricing path.
Quote a fare, request a ride, and follow it to completion. A quote returns real road distance, driving time and the final price per vehicle tier, tax included — the same figures the Ryde apps show, because they come from the same pricing path.
Lifecycle
QUOTED
|
REQUESTED -----> no driver found -----> cancelled
|
MATCHING (offers go out to nearby drivers in rounds,
| widening the search radius as they lapse)
DRIVER ASSIGNED
|
DRIVER EN ROUTE
|
DRIVER ARRIVED
|
TRIP STARTED
|
COMPLETED (or CANCELLED, before it starts)Operations
GET /v1/rides/products
Coming soon Sandbox supported
The vehicle tiers that can be requested, with each tier's base fare.
| Operation | search_ride_options |
|---|---|
| Scope | rides.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | search_ride_options |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/rides/products' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/rides/quote
Coming soon Sandbox supported
Road distance, driving time and the final fare per vehicle tier, tax included. Returns the quote_id request_ride requires.
| Operation | quote_ride |
|---|---|
| Scope | rides.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | quote_ride |
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/rides/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/rides
Coming soon Ryde One required Sandbox supported
Request the ride the customer confirmed, from a quote_id they were shown.
| Operation | request_ride |
|---|---|
| Scope | rides.request |
| Entitlement | Ryde One required |
| Idempotency | Required |
| MCP tool | request_ride |
Requires a fresh quote the customer was shown, plus an Idempotency-Key.
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/rides' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/rides/{ride_id}
Coming soon Sandbox supported
Live state of one ride: dispatch progress, the assigned driver and vehicle, and the pickup ETA. Never membership-gated — a ride in progress stays trackable.
| Operation | get_ride |
|---|---|
| Scope | rides.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | get_ride |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/rides/$ride_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"GET /v1/rides
Coming soon Sandbox supported
The customer's own ride history, newest first.
| Operation | list_rides |
|---|---|
| Scope | rides.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | list_rides |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/rides' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/rides/{ride_id}/cancel
Coming soon Sandbox supported
Cancel a ride that has not started. Never membership-gated, for the same reason as cancelling an order.
| Operation | cancel_ride |
|---|---|
| Scope | rides.read |
| Entitlement | None |
| Idempotency | Supported |
| MCP tool | cancel_ride |
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/rides/$ride_id/cancel' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'