> ## Documentation Index > Fetch the complete documentation index at: https://docs.usesimple.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Feedback > List feedback left on call transcripts ## OpenAPI ````yaml GET /feedback openapi: 3.1.0 info: title: Public API v1 description: >- Public API v1 requiring API keys. **Timestamps:** All datetime fields in API responses are returned in UTC using ISO 8601 format (e.g., `2024-01-15T14:30:00Z`). When filtering by date parameters, provide timestamps in ISO 8601 format. version: 0.1.0 servers: - url: https://api.prod.usesimple.ai/api/v1 description: Production API Server security: [] paths: /feedback: get: tags: - Feedback summary: List Feedback description: >- List utterance feedback left on call transcripts for your organization. Supports filtering and pagination. operationId: list_feedback_feedback_get parameters: - name: page in: query required: false schema: type: integer default: 1 title: Page description: Page number for pagination - name: page_size in: query required: false schema: type: integer default: 20 maximum: 100 title: Page Size description: Number of feedback entries per page (max 100) - name: category in: query required: false schema: type: string enum: - wrong_response - hallucination - tone - missed_intent - transcription_error - other title: Category description: Filter by feedback category - name: agent_id in: query required: false schema: type: string format: uuid title: Agent ID description: Filter by agent UUID - name: call_id in: query required: false schema: type: string format: uuid title: Call ID description: Filter by call UUID - name: resolved in: query required: false schema: type: boolean title: Resolved description: Filter by resolved state (true = marked as fixed, false = open) - name: created_at_gte in: query required: false schema: type: string format: date-time title: Created At Greater Than or Equal description: Filter feedback created at or after this datetime (ISO 8601 format) - name: created_at_lte in: query required: false schema: type: string format: date-time title: Created At Less Than or Equal description: Filter feedback created at or before this datetime (ISO 8601 format) responses: '200': description: Successful Response content: application/json: schema: type: object properties: feedback: type: array items: $ref: '#/components/schemas/UtteranceFeedbackResponse' total_count: type: integer title: Total Count page: type: integer title: Page page_size: type: integer title: Page Size total_pages: type: integer title: Total Pages required: - feedback - total_count - page - page_size - total_pages title: Utterance Feedback List Response '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: UtteranceFeedbackResponse: type: object required: - uuid - transcript_entry_id - feedback_text - resolved - created_at - notes properties: uuid: type: string format: uuid title: UUID description: Unique identifier for the feedback entry call_id: anyOf: - type: string format: uuid - type: 'null' title: Call ID description: UUID of the call the feedback belongs to transcript_entry_id: type: string title: Transcript Entry ID description: >- Identifier of the transcript entry (utterance) the feedback was left on category: anyOf: - type: string enum: - wrong_response - hallucination - tone - missed_intent - transcription_error - other - type: 'null' title: Category description: Feedback category utterance_text: anyOf: - type: string - type: 'null' title: Utterance Text description: Text of the utterance the feedback was left on utterance_role: anyOf: - type: string - type: 'null' title: Utterance Role description: Speaker role of the utterance (e.g. 'assistant' or 'user') feedback_text: type: string title: Feedback Text description: The feedback left by the reviewer corrected_response: anyOf: - type: string - type: 'null' title: Corrected Response description: Suggested corrected response, if one was provided agent_id: anyOf: - type: string format: uuid - type: 'null' title: Agent ID description: UUID of the agent the feedback was recorded against agent_name: anyOf: - type: string - type: 'null' title: Agent Name description: Name of the agent at the time the feedback was created node_name: anyOf: - type: string - type: 'null' title: Node Name description: Name of the agent node the utterance came from, if known resolved: type: boolean title: Resolved description: Whether the feedback has been marked as fixed resolved_at: anyOf: - type: string format: date-time - type: 'null' title: Resolved At description: When the feedback was marked as fixed (null if unresolved) created_at: type: string format: date-time title: Created At description: When the feedback was created submitted_by: anyOf: - type: object properties: email: anyOf: - type: string - type: 'null' title: Email description: Submitter's email address first_name: anyOf: - type: string - type: 'null' title: First Name description: Submitter's first name last_name: anyOf: - type: string - type: 'null' title: Last Name description: Submitter's last name - type: 'null' title: Submitted By description: The user who submitted the feedback (null if unavailable) notes: type: array items: $ref: '#/components/schemas/UtteranceFeedbackNoteResponse' title: Notes description: Discussion notes attached to the feedback entry title: Utterance Feedback Response HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError UtteranceFeedbackNoteResponse: type: object required: - note_text - created_at properties: author_name: anyOf: - type: string - type: 'null' title: Author Name description: Display name of the note author note_text: type: string title: Note Text description: The text content of the note created_at: type: string format: date-time title: Created At description: When the note was created title: Utterance Feedback Note Response ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: Authorization ````