Get All Order Reviews

Review Manager API - Fetch Reviews

This endpoint allows you to retrieve reviews associated with specific listings within a defined date range. You can specify the number of reviews to return, as well as pagination options.

Request

HTTP Method

POST

URL

{{base-url}}/v1/partnerApi/review-manager/reviews?limit=3&offset=1&order=-1

Request Body

The request body must be in JSON format and includes the following parameters:

Example Request Body

{
    "startDate": "2025-06-06",
    "endDate": "2025-07-06",
    "listingIds": [
        "P67071",
        "P67073"
    ],
    "channel": [
        "DOORDASH",
        "UBEREATS",
        "GRUBHUB"
    ]}

Response

Response Body

The response will be in JSON format and contains the following structure:

Result Structure

The result object may contain the following keys:

Reviews Array Structure

Each object in the reviews array contains the following fields:

Example Response

{
  "status": true,
  "statusCode": 200,
  "message": "Reviews fetched successfully",
  "result": {
    "total": 33,
    "reviews": [
      {
        "uuid": "cfcd296b-214b-3001-923f-9a406df4424b",
        "date": "2025-07-05T01:08:44.000Z",
        "daysLeftToReply": 3,
        "orderSubTotal": 15.49,
        "CustomerId": "524823061",
        "storeId": "P6707",
        "brandId": "393",
        "deliveryUUID": "cfcd296b-214b-3001-923f-9a406df4424b",
        "toBeReviewed": null,
        "reviewId": null,
        "CustomerName": "Camilo T",
        "ListingId": "P67071",
        "channel": "DOORDASH",
        "orderRating": 5,
        "reviewReplyPromoValue": null,
        "orderFeedback": "",
        "reviewReplyComment": null,
        "orderDate": null,
        "reviewCreated": "2025-07-05T01:08:44.000Z",
        "reviewReplyCreated": null,
        "reviewReplied": false,
        "yelpReplyApproved": false,
        "customerType": "new",
        "autoReply": false
        "ddReviewType": "STAR_RATING",
        "ddReviewValue": "FIVE"
      }
    ],
    "totalUnAnswered": 5,
    "unAnsweredReviews": [
      {
        "uuid": "cfcd296b-214b-3001-923f-9a406df4424b",
        "date": "2025-07-05T01:08:44.000Z",
        "daysLeftToReply": 3,
        "orderSubTotal": 15.49,
        "CustomerId": "524823061",
        "storeId": "P6707",
        "brandId": "393",
        "deliveryUUID": "cfcd296b-214b-3001-923f-9a406df4424b",
        "toBeReviewed": null,
        "reviewId": null,
        "CustomerName": "Camilo T",
        "ListingId": "P67071",
        "channel": "DOORDASH",
        "orderRating": 5,
        "reviewReplyPromoValue": null,
        "orderFeedback": "",
        "reviewReplyComment": null,
        "orderDate": null,
        "reviewCreated": "2025-07-05T01:08:44.000Z",
        "reviewReplyCreated": null,
        "reviewReplied": false,
        "yelpReplyApproved": false,
        "customerType": "new",
        "autoReply": false,
        "ddReviewType": "THREE_BUTTON_RATING",
        "ddReviewValue": "LOVED"
      }
    ],
    "totalYelp": 0,
    "yelpReviews": [],
    "unansweredYelp": 0,
    "unansweredReviewsYelp": []
  },
  "error": null
}

Status Codes

• 200 OK: The request was successful, and the response contains the requested data.

• Other Status Codes: Refer to the API documentation for additional status codes and their meanings.

This endpoint is essential for managing and analyzing reviews across different channels, helping businesses to respond effectively to customer feedback.