Rate Order
Submit a star rating for a completed order. Only available once the order is in Completed state. Can only be submitted once per order.
Submit Rating
POST/ret11/rating
Auth Required
Include a Bearer token.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| orderId | string | required | The completed order to rate |
| orderRating | number | required | Overall order rating from 1 (lowest) to 5 (highest) |
| providerRating | number | optional | Rating for the restaurant/provider (1–5) |
| agentRating | number | optional | Rating for the delivery agent (1–5) |
| fulfilmentRating | number | optional | Rating for the delivery/fulfillment experience (1–5) |
| itemRatings | array | optional | Per-item ratings. Each entry: { "itemId": string, "rating": number } |
Request Example
{
"orderId": "019d1476113e75598fa4d0389075cef0",
"orderRating": 4,
"providerRating": 5,
"agentRating": 4,
"itemRatings": [
{ "itemId": "id_1cctu3_9_0", "rating": 5 }
]
}Response
Returns ONDC on_rating acknowledgment with a feedback form URL.
Response Example
{
"data": {
"dto": {
"context": {
"domain": "ONDC:RET11",
"country": "IND",
"city": "std:080",
"action": "on_rating",
"core_version": "1.2.0",
"bap_id": "ondc.preprod.highwaydelite.com",
"bap_uri": "https://ondc.preprod.highwaydelite.com/ret11",
"bpp_id": "pramaan.ondc.org/beta/preprod/mock/seller",
"bpp_uri": "https://pramaan.ondc.org/beta/preprod/mock/seller",
"transaction_id": "56a55c3f-8052-4bb6-91d6-47e1a178a0c0",
"message_id": "e4f5a6b7-c8d9-0123-4567-89abcdef0123",
"timestamp": "2026-06-01T11:00:00.000Z"
},
"message": {
"order_id": "019d1476113e75598fa4d0389075cef0",
"feedback_form": {
"form": {
"url": "https://www.sellerapp.com/rating-capture",
"mime_type": "text/html"
}
}
}
},
"status": "ACK"
}
}One-Time Submission
Ratings cannot be updated after submission. The rating field in order-details will reflect the submitted value.