Book Ride

Submit a booking request with pickup and drop-off details. The server automatically associates the ride with your account and sets the initial status to REQUESTED. Authentication required — include Authorization: Bearer <token> in the request header.

Request

POST /rides/book

string

Human-readable name or address of the pickup location.

string

Human-readable name or address of the drop-off location.

number

Latitude of the pickup point.

number

Longitude of the pickup point.

number

Latitude of the drop-off point.

number

Longitude of the drop-off point.

string

Landmark or additional detail for the pickup location (up to 600 characters).

string

Landmark or additional detail for the drop-off location (up to 600 characters).

string

Payment method for the ride (e.g., CASH, CARD, WALLET).

Response

number

Unique identifier for the created ride.

string

Always REQUESTED on creation.

number

The ID of the authenticated rider who booked the ride.

number

Computed fare for the ride.

string

Pickup location as provided in the request.

string

Drop-off location as provided in the request.

number

Pickup latitude.

number

Pickup longitude.

number

Drop-off latitude.

number

Drop-off longitude.

string

Pickup landmark.

string

Drop-off landmark.

string

Payment mode as provided in the request.

string

OTP the driver must verify before starting the ride.

string

OTP the rider must confirm to mark the ride as complete.

string

ISO 8601 timestamp of when the ride was created.

Example

curl -X POST "http://localhost:8080/rides/book" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "pickupLocation": "MG Road, Bangalore",
    "dropLocation": "Indiranagar, Bangalore",
    "pickupLat": 12.9757,
    "pickupLon": 77.6011,
    "dropLat": 12.9784,
    "dropLon": 77.6408,
    "pickupLandmark": "Near Café Coffee Day",
    "dropLandmark": "Opposite HDFC Bank",
    "paymentMode": "CASH"
  }'

{
  "id": 1021,
  "status": "REQUESTED",
  "riderId": 42,
  "fare": 145.00,
  "pickupLocation": "MG Road, Bangalore",
  "dropLocation": "Indiranagar, Bangalore",
  "pickupLat": 12.9757,
  "pickupLon": 77.6011,
  "dropLat": 12.9784,
  "dropLon": 77.6408,
  "pickupLandmark": "Near Café Coffee Day",
  "dropLandmark": "Opposite HDFC Bank",
  "paymentMode": "CASH",
  "startOtp": "4821",
  "endOtp": "7364",
  "createdAt": "2026-04-02T10:15:30Z"
}

The status field is always set to REQUESTED by the server regardless of any value you send in the request body.

Authentication

Rides

Payments

Notifications & Settings

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example