Skip to content

Agentic Services Protocol (ASP)

Reviews

Reviews¶

Capability: dev.asp.services.reviews
Version: 2026-02-19
Schema: reviews.json

Purpose¶

Enables agents to close the service loop by submitting post-service reviews and retrieving provider review history for better recommendations.

Endpoints¶

POST /reviews
GET  /reviews/{provider_id}

Submit Review¶

Request payload (`submit_review_request`)¶

Field	Type	Required	Description
`order_id`	string	Yes	The order being reviewed.
`provider_id`	string	Yes	The provider being reviewed.
`rating`	number	Yes	Overall rating out of 5.
`comment`	string	No	Optional free-text review.
`scores`	object	No	Optional category scores.

Response payload¶

Field	Type	Required	Description
`id`	string	Yes	Unique review identifier.
`order_id`	string	Yes	The order this review is for.
`provider_id`	string	Yes	The provider being reviewed.
`rating`	number	Yes	Overall rating out of 5.
`comment`	string	No	Optional free-text review.
`scores`	object	No	Optional category scores, e.g. {"food": 5, "delivery": 3} or {"cleanliness": 4, "location": 5}.
`created_at`	string	Yes	When the review was submitted.

Get Provider Reviews¶

Request¶

Field	Type	Required	Description
`provider_id`	string	Yes	The provider whose reviews to retrieve.
`page`	integer	No	Page number. Default: `1`
`page_size`	integer	No	Number of reviews per page. Default: `20`

Response payload (`get_reviews_response`)¶

Field	Type	Required	Description
`reviews`	array\<review>	Yes	List of reviews.
`average_rating`	number	Yes	Provider's average rating across all reviews.
`total_reviews`	integer	Yes	Total number of reviews for this provider.
`has_more`	boolean	No	Whether more pages of reviews are available.

Example¶

{
  "order_id": "ord_123",
  "provider_id": "pizza-palace",
  "rating": 5,
  "comment": "Excellent service and fast delivery.",
  "scores": {
    "food": 5,
    "delivery": 5,
    "value": 4
  }
}