> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API Reviews

> Un Review est la note en étoiles d'un client, accompagnée d'un commentaire écrit facultatif, sur un produit, affichée sur la page boutique du produit.

Utilisez l'API Reviews pour lister les avis d'un produit, filtrés par note en étoiles ou par date de création, et récupérer un avis par son ID.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les avis](https://docs.whop.com/fr/api-reference/reviews/list-reviews.md) | GET `/reviews` |
| [Récupérer un avis](https://docs.whop.com/fr/api-reference/reviews/retrieve-review.md) | GET `/reviews/{id}` |
| [Supprimer un avis](https://docs.whop.com/fr/api-reference/reviews/delete-review.md) | DELETE `/reviews/{id}` |

## Attributs

**id** `string` *required*

L'identifiant unique de l'avis.

**account** `object` *required*

Le compte pour lequel cet avis a été rédigé.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'identifiant unique du compte.
>
> **route** `string` *required*
>
> Slug d'URL de la page boutique du compte. Par exemple, `pickaxe` dans
> whop.com/pickaxe.
>
> **title** `string` *required*
>
> Le nom d'affichage du compte présenté aux clients.

**attachments** `object[]` *required*

Une liste de fichiers et de médias joints à l'avis.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'identifiant unique de la pièce jointe.
>
> **content\_type** `string | null` *required*
>
> Type MIME du fichier importé, par exemple image/jpeg, video/mp4 ou audio/mpeg.
>
> **filename** `string | null` *required*
>
> Le nom de fichier d'origine de la pièce jointe importée, extension de fichier
> comprise.
>
> **url** `string | null` *required*
>
> Une URL pré-optimisée pour afficher cette pièce jointe côté client. À utiliser pour afficher les pièces jointes dans les apps.

**created\_at** `string` *required*

Date de création de l'avis, sous forme d'horodatage ISO 8601.

**description** `string | null` *required*

Le corps de l'avis contenant le commentaire détaillé de l'utilisateur. Renvoie
une chaîne vide si aucune description n'a été fournie.

**joined\_at** `string | null` *required*

Date à laquelle l'auteur de l'avis a rejoint le produit pour la première fois,
sous forme d'horodatage ISO 8601. Null si inconnue.

**paid\_for\_product** `boolean | null` *required*

Indique si l'auteur de l'avis a payé le produit. Null si le statut de paiement
est inconnu.

**product** `object` *required*

Le produit pour lequel cet avis a été rédigé.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'identifiant unique du produit.
>
> **title** `string` *required*
>
> Le nom d'affichage du produit présenté aux clients sur la page produit et dans les résultats de recherche.

**published\_at** `string | null` *required*

Date de publication de l'avis, sous forme d'horodatage ISO 8601. Null si inconnue.

**stars** `integer` *required*

La note en étoiles attribuée par l'auteur de l'avis, de 1 à 5.

**status** `string` *required*

Le statut de modération de l'avis. Seuls les avis publiés sont renvoyés.

Options disponibles : `published`

**title** `string | null` *required*

Un court titre résumant l'avis. Null si l'auteur de l'avis n'en a pas fourni.

**updated\_at** `string` *required*

Date de la dernière mise à jour de l'avis, sous forme d'horodatage ISO 8601.

**user** `object` *required*

Le compte utilisateur de la personne qui a rédigé cet avis.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'identifiant unique de l'utilisateur.
>
> **name** `string | null` *required*
>
> Le nom d'affichage de l'utilisateur présenté sur son profil public.
>
> **username** `string` *required*
>
> Le nom d'utilisateur unique de l'utilisateur présenté sur son profil public.

```json Review theme={null}
{
	"id": "rev_xxxxxxxxxxxxxx",
	"title": "Worth every penny",
	"description": "Two years on and the paint still beads like the day it was coated.",
	"stars": 5,
	"status": "published",
	"paid_for_product": true,
	"created_at": "2026-09-20T18:02:00.000Z",
	"updated_at": "2026-09-20T18:02:00.000Z",
	"published_at": "2026-09-20T18:02:00.000Z",
	"joined_at": "2024-08-11T14:00:00.000Z",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"username": "danawhitfield"
	},
	"attachments": [
		{
			"id": "file_xxxxxxxxxxxxxx",
			"filename": "coated-hood.png",
			"content_type": "image/png",
			"url": "https://img.whop.com/uploads/coated-hood.png"
		}
	],
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing",
		"route": "shine-time-auto-detailing"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxxx",
		"title": "Ceramic Coating Package"
	}
}
```


## Related topics

- [API Review Reports](https://docs.whop.com/fr/api-reference/review-reports/review-report.md)
- [List reviews](https://docs.whop.com/fr/api-reference/legacy/reviews/list-reviews.md)
- [Retrieve review](https://docs.whop.com/fr/api-reference/legacy/reviews/retrieve-review.md)
