Submit Feedback

Submit a rating and optional comment for a ride you participated in. The ride must be in COMPLETED status before feedback can be accepted. Authentication required — include Authorization: Bearer <token> in the request header.

Request

POST /rides/feedback/{rideId}

number

required

The unique ID of the completed ride.

integer

required

Your rating for the ride. Must be an integer between 1 and 5 (inclusive).

string

Optional written feedback. Stored in riderFeedback on the ride (up to 600 characters).

Response

number

Unique ride identifier.

string

Remains COMPLETED after feedback is submitted.

number

The rating you submitted (1–5).

string

The comment you submitted, or an empty string if none was provided.

number

ID of the rider.

number

ID of the driver.

number

Fare for the ride.

string

Pickup address.

string

Drop-off address.

string

ISO 8601 timestamp of ride creation.

Example

curl -X POST "http://localhost:8080/rides/feedback/1021" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "rating": 5,
    "comment": "Great driver, very smooth ride!"
  }'

{
  "id": 1021,
  "status": "COMPLETED",
  "riderId": 42,
  "driverId": 7,
  "fare": 145.00,
  "pickupLocation": "MG Road, Bangalore",
  "dropLocation": "Indiranagar, Bangalore",
  "riderRating": 5,
  "riderFeedback": "Great driver, very smooth ride!",
  "createdAt": "2026-04-02T10:15:30Z"
}

Feedback can only be submitted for rides with status COMPLETED. Attempting to submit feedback on a ride in any other status returns a 400 Bad Request.

If rating is missing, non-numeric, or outside the range 1–5, the server returns 400 Bad Request with the message: "Rating must be a number between 1 and 5."

Omitting the comment field is valid — the server stores an empty string for riderFeedback in that case. You must still provide a valid rating.

Authentication

Rides

Payments

Notifications & Settings

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example