# List reviews

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

## `GET /reviews`

**List reviews**

Returns paginated reviews. Supports filtering by status, rating,
locale, and date range.

Required permissions: `reviews.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | number | No | Number |
| `limit` | query | number | No | Number <= 100 |
| `status` | query | "pending" \| "approved" \| "rejected" | No | One of: pending, approved, rejected |
| `rating` | query | number | No | Between 1 and 5 |
| `ratingMin` | query | number | No | Between 1 and 5 |
| `ratingMax` | query | number | No | Between 1 and 5 |
| `isFeatured` | query | boolean | No | Boolean |
| `productName` | query | string | No | Associated product name |
| `source` | query | "admin" \| "csv_import" \| "public_form" | No | One of: admin, csv_import, public_form |
| `search` | query | string | No | Full-text search query |
| `sortBy` | query | "created_at" \| "rating" \| "author_name" \| "display_order" \| "review_date" | No | One of: created_at, rating, author_name, display_order, review_date |
| `sortOrder` | query | "asc" \| "desc" | No | One of: asc, desc |
| `dateFrom` | query | string | No | Filter from date (ISO 8601) |
| `dateTo` | query | string | No | Filter until date (ISO 8601) |
| `reviewDateFrom` | query | string | No | Filter by review date from (ISO 8601) |
| `reviewDateTo` | query | string | No | Filter by review date until (ISO 8601) |
| `slug` | query | string | No | URL-friendly identifier, unique per site and locale |
| `slugs` | query | string[] | No | Array of strings |
| `ids` | query | string[] | No | Array of strings |
| `excludeIds` | query | string[] | No | Array of strings |
| `groupByTranslation` | query | boolean | No | Boolean |
| `locale` | query | string | No | BCP 47 locale code (e.g. "en", "fr") |
| `translationGroupId` | query | string | No | Translation group UUID (links translations across locales) |


### Responses

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


### Examples

```bash
# List approved reviews
curl "https://api.lynkow.com/v1/reviews?status=approved&page=1&limit=10" \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": [
    {
      "id": 101,
      "title": "Excellent platform",
      "content": "Lynkow made managing our website content incredibly easy.",
      "rating": 5,
      "status": "approved",
      "authorName": "Marie Dupont",
      "authorEmail": "marie@example.com",
      "authorCompany": "Acme Corp",
      "authorCity": "Paris",
      "isFeatured": true,
      "locale": "en",
      "createdAt": "2025-04-01T14:22:00.000Z"
    },
    {
      "id": 102,
      "title": "Good but could improve",
      "content": "The API is solid. Would love to see webhooks for reviews.",
      "rating": 4,
      "status": "approved",
      "authorName": "John Smith",
      "authorEmail": "john@example.com",
      "authorCompany": null,
      "authorCity": "London",
      "isFeatured": false,
      "locale": "en",
      "createdAt": "2025-03-28T09:15:00.000Z"
    }
  ],
  "meta": {
    "total": 67,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 5,
    "averageRating": "4.35",
    "totalApproved": 54
  }
}
```

---