Reviews

List reviews

Changed on

Lists the published reviews for a product or account. Without account_id or product_id, a user lists the reviews they wrote, an account or app API key lists its account's reviews, and a request without credentials returns 400.

get/reviews

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/reviews
  • Auth: HTTP bearer

Query parameters

account_idstring
Example:biz_xxxxxxxxxxxxxx

The unique identifier of the account to list reviews for.

product_idstring
Example:prod_xxxxxxxxxxxxx

The unique identifier of the product to list reviews for.

min_starsinteger

The minimum star rating to include in results, from 1 to 5 inclusive.

max_starsinteger

The maximum star rating to include in results, from 1 to 5 inclusive.

created_beforestring date-time

Only return reviews created before this timestamp.

created_afterstring date-time

Only return reviews created after this timestamp.

order'created_at' | 'stars'

The field to sort reviews by.

direction'asc' | 'desc'

The sort direction.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

Reviews for the product

Example response

{
  "data": [
    {
      "attachments": [
        {
          "content_type": "image/png",
          "filename": "coated-hood.png",
          "id": "file_xxxxxxxxxxxxxx",
          "url": "https://img.whop.com/xxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx/mb:180000/plain/https://assets-2-rough.whop.com/uploads/image/2026-01-01/review-coated-hood"
        }
      ],
      "created_at": "2026-01-01T12:00:00.000Z",
      "description": "Two years on and the paint still beads like the day it was coated.",
      "id": "rev_xxxxxxxxxxxxxx",
      "joined_at": "2026-01-01T12:00:00.000Z",
      "paid_for_product": true,
      "published_at": "2026-01-01T12:00:00.000Z",
      "stars": 4,
      "status": "published",
      "title": "Worth every penny",
      "updated_at": "2026-01-01T12:00:00.000Z",
      "user": {
        "id": "user_xxxxxxxxxxxxxx",
        "name": "Dana Whitfield",
        "username": "danawhitfield"
      }
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

  • 507636677fe9Revision changes
    • breaking

      for the query request parameter first, default value 20 was added

    • breaking

      the // response's property format changed from date-time to no format for status

    • breaking

      the // response's property format changed from date-time to no format for status

    • breaking

      the // response's property format changed from date-time to no format for status

    • breaking

      the // response's property format changed from date-time to no format for status

    • warning

      for the query request parameter first, the max was set to 100.00

    • warning

      for the query request parameter last, the max was set to 100.00

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional header request parameter Api-Version-Date to all path's operations

    • info

      added the new optional query request parameter account_id

    • info

      added the new optional query request parameter direction

    • info

      added the new optional query request parameter order

    • info

      the query request parameter product_id became optional

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the pending enum value from the // response property for the response status

    • info

      removed the removed enum value from the // response property for the response status