# Get review statistics

**Publié le** : 2026-05-08
**Catégorie** : Forms & Reviews

## `GET /reviews/stats`

**Get review statistics**

Returns aggregate statistics: average rating, total count, and
distribution by rating (1-5 stars).

Required permissions: `reviews.view`

### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |


### Examples

```bash
curl https://api.lynkow.com/v1/reviews/stats \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "total": 67,
  "byStatus": {
    "pending": 8,
    "approved": 54,
    "rejected": 5
  },
  "averageRating": 4.35,
  "ratingDistribution": {
    "1": 2,
    "2": 3,
    "3": 8,
    "4": 17,
    "5": 24
  },
  "featuredCount": 6,
  "thisMonth": 12
}
```

---