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

# List reviews



## OpenAPI

````yaml https://files.easyflows.io/openapi.json get /api/v1/app/reviews
openapi: 3.0.0
info:
  title: Easyflows
  version: v1
servers:
  - url: https://{subdomain}.easyflows.io
    variables:
      subdomain:
        default: demo
        description: Subdomain of the project
security: []
paths:
  /api/v1/app/reviews:
    get:
      tags:
        - Reviews
      summary: List reviews
      parameters:
        - schema:
            type: number
            nullable: true
            default: 1
            description: The page number for pagination.
          required: false
          description: The page number for pagination.
          name: page
          in: query
        - schema:
            type: number
            nullable: true
            default: 20
            description: The number of items per page.
          required: false
          description: The number of items per page.
          name: limit
          in: query
        - schema:
            type: string
            description: The reference of the product for which to list reviews.
          required: false
          description: The reference of the product for which to list reviews.
          name: product_ref
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 5
            description: Filter reviews by rating.
          required: false
          description: Filter reviews by rating.
          name: rating
          in: query
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Review'
                    description: The array of data returned by the API endpoint.
                  meta:
                    type: object
                    properties:
                      total:
                        type: number
                        description: The total number of items available.
                        example: 1
                      page:
                        type: number
                        description: The current page number.
                        example: 1
                      limit:
                        type: number
                        description: The number of items per page.
                        example: 20
                    required:
                      - total
                      - page
                      - limit
                    description: Metadata about the paginated response.
                required:
                  - data
                  - meta
        '400':
          description: Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: A description of the error that occurred.
                required:
                  - error
components:
  schemas:
    Review:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the review.
          example: 27e460ed-1e9c-4097-9f7e-12db081aa5c2
        rating:
          type: number
          minimum: 1
          maximum: 5
          description: The rating given by the reviewer.
          example: 5
        title:
          type: string
          description: The title of the review.
          example: Great product!
        body:
          type: string
          description: The body content of the review.
          example: I really like this product.
        customer:
          type: boolean
          description: Indicates if the reviewer is a customer.
          example: true
        approved:
          type: boolean
          description: Indicates if the review is approved/published.
          example: true
        member:
          allOf:
            - $ref: '#/components/schemas/Member'
            - description: The member who wrote the review.
        product:
          $ref: '#/components/schemas/Product'
        created_at:
          type: string
          description: The date and time when the review was created.
          example: '2026-01-01T12:00:00Z'
        updated_at:
          type: string
          description: The date and time when the review was last updated.
          example: '2026-01-01T12:00:00Z'
      required:
        - id
        - rating
        - body
        - customer
        - approved
        - member
        - created_at
        - updated_at
    Member:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the member.
          example: f804cfec-39ec-45cc-845a-4fe51b80d2f0
        name:
          type: string
          description: The name of the member.
          example: John Doe
      required:
        - id
        - name
    Product:
      type: object
      nullable: true
      properties:
        id:
          type: string
          description: The unique identifier of the product.
          example: 0b0abfba-18a4-4b7e-9179-e0cec1f2994f
        ref:
          type: string
          description: The reference identifier of the product (inside platform).
          example: tebex-5ea84f
        platform:
          type: string
          description: The platform of the product (e.g. Tebex).
          example: tebex
        name:
          type: string
          description: The name of the product.
          example: Example Product
        image:
          type: string
          description: The image URL of the product.
          example: https://example.com/image.jpg
        description:
          type: string
          description: The description of the product.
          example: This is an example product.
      required:
        - id
        - ref
        - platform
        - name
      description: The product that the review is about.

````