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

# List customer feedback requests

> Retrieve a paginated list of customer feedback requests for the authenticated vendor.
Supports filtering by status.




## OpenAPI

````yaml /openapi.yaml get /customer-feedback-system
openapi: 3.0.3
info:
  title: RenovationFind API
  description: >
    Public REST API for RenovationFind vendor integrations.


    ## Authentication

    All endpoints require a Bearer token in the `Authorization` header.

    Tokens are issued from the RenovationFind Manager Portal.


    ```

    Authorization: Bearer <your_jwt_token>

    ```


    ## Rate Limiting

    API requests are rate-limited to **250 requests per 5 minutes** per vendor.

    When exceeded, the API returns `429 Too Many Requests` with a `Retry-After`
    header.


    ## Response Format

    All responses follow a consistent envelope:

    ```json

    {
      "success": true,
      "data": { ... },
      "message": "Optional message"
    }

    ```

    On error:

    ```json

    {
      "success": false,
      "error": "Error description"
    }

    ```
  version: 1.0.0
  contact:
    name: RenovationFind
    url: https://www.renovationfind.com
servers:
  - url: https://www.renovationfind.com/rest-api-v1
    description: Production
security:
  - BearerAuth: []
paths:
  /customer-feedback-system:
    get:
      tags:
        - Customer Feedback
      summary: List customer feedback requests
      description: >
        Retrieve a paginated list of customer feedback requests for the
        authenticated vendor.

        Supports filtering by status.
      operationId: listCfsRequests
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 0
            minimum: 0
        - name: size
          in: query
          required: false
          description: Page size (max 100)
          schema:
            type: integer
            default: 10
            minimum: 1
            maximum: 100
        - name: filter
          in: query
          required: false
          schema:
            type: string
            default: ALL
            enum:
              - ALL
              - FLAGGED
              - FULLY_COMPLETED
              - DELIVERY_SENT
              - DELIVERY_PENDING
              - DELIVERY_FAILED
              - FEEDBACK_COMPLETED
              - REVIEW_COMPLETED
              - REFERRAL_COMPLETED
      responses:
        '200':
          description: Paginated list of customer feedback requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      content:
                        type: array
                        items:
                          type: object
                          description: A customer feedback request
                          properties:
                            id:
                              type: integer
                              format: int64
                            customerName:
                              type: string
                            email:
                              type: string
                            phone:
                              type: string
                            dateCreated:
                              type: string
                              format: date-time
                            dateModified:
                              type: string
                              format: date-time
                            dateRequestSent:
                              type: string
                              format: date-time
                            deliveryStatus:
                              type: string
                              enum:
                                - PENDING
                                - SENT
                                - FAILED
                            config:
                              type: string
                              enum:
                                - FEEDBACK_REVIEW_REFERRAL
                                - FEEDBACK_REVIEW
                                - FEEDBACK_REFERRAL
                                - FEEDBACK
                            feedbackCompleted:
                              type: boolean
                            flaggedFeedback:
                              type: boolean
                              description: >-
                                Auto-flagged when satisfaction rating is POOR,
                                FAIR, or AVERAGE
                            satisfactionRating:
                              type: string
                              enum:
                                - POOR
                                - FAIR
                                - AVERAGE
                                - GOOD
                                - EXCELLENT
                              nullable: true
                            comments:
                              type: string
                              nullable: true
                            reviewCompleted:
                              type: boolean
                            googleReviewCompleted:
                              type: boolean
                            facebookReviewCompleted:
                              type: boolean
                            bbbReviewCompleted:
                              type: boolean
                            otherReviewCompleted:
                              type: boolean
                            referralCompleted:
                              type: boolean
                            referralByEmailTextCompleted:
                              type: boolean
                            referralByFbCompleted:
                              type: boolean
                            referralConversionCount:
                              type: integer
                              format: int64
                      page:
                        type: integer
                      size:
                        type: integer
                      totalElements:
                        type: integer
                        format: int64
                      totalPages:
                        type: integer
                      last:
                        type: boolean
        '429':
          description: Rate limit exceeded (250 requests per 5 minutes)
          headers:
            Retry-After:
              schema:
                type: integer
                example: 300
              description: Seconds to wait before retrying
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  error:
                    type: string
              example:
                success: false
                error: >-
                  Rate limit exceeded. Maximum 250 requests per 5 minutes.
                  Please retry later.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token issued from the RenovationFind Manager Portal

````