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

# List data feedback

> Lists data feedback tickets for your organization.

Lists data feedback tickets associated with your organization.

## Example

```bash curl theme={null}
curl "https://api.kernel.ai/rest/v1/feedback?limit=2" \
  -H "x-api-key: $KERNEL_API_KEY"
```

```json Response (200) theme={null}
{
  "data": [
    {
      "id": "160857402",
      "status": "received",
      "category": "headcount",
      "external_id": "0010700000n0QXkAAM",
      "kernel_id": "1594610357",
      "field": "kernel_headcount_effective",
      "current_value": "130",
      "expected_value": "500",
      "comment": "Filing shows 500.",
      "evidence_url": null,
      "created_at": "2026-10-29T11:21:35.323Z",
      "resolved_at": null,
      "account": {
        "trading_name": "SimScale",
        "legal_name": "SimScale GmbH"
      }
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 0
}
```

## Query parameters

| Parameter | Type | Description |
| - | - | - |
| `status` | `string` | Optional filter. One of: `received`, `in_review`, `on_hold`, `resolved`, `resolved_not_for_kernel`. |
| `limit` | `number` | Page size, 1–100. Defaults to `25`. |
| `offset` | `number` | Number of tickets to skip. Defaults to `0`. |

## Response fields

| Field | Type | Description |
| - | - | - |
| `data` | `array` | Tickets on this page. Same shape as [get data feedback](https://dev.kernel.ai/api-reference/endpoint/get-feedback.md). |
| `total` | `number` | Total tickets matching the filter. |
| `limit` | `number` | Page size used. |
| `offset` | `number` | Offset used. |

## Errors

| Status | Response | Cause |
| - | - | - |
| 401 | `{"error":"Missing x-api-key header"}` | No API key provided |
| 403 | `{"error":"Data feedback loop is not available."}` | Data feedback is not available for this organization |
| 400 | `{"error":"Invalid query"}` | Query parameters are invalid |
| 503 | `{"error":"Service unavailable"}` | Backend temporarily unavailable |


## OpenAPI

````yaml GET /v1/feedback
openapi: 3.1.0
info:
  title: Kernel API
  description: Resolve company identities to canonical entities with a simple async API
  version: 1.0.0
  contact:
    email: support@kernel.ai
  license:
    name: MIT
servers:
  - url: https://api.kernel.ai/rest
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Entity Resolution
    description: Resolve a company to a canonical entity
  - name: Firmographics
    description: Retrieve and enrich firmographic data for resolved entities
  - name: Parentage
    description: Look up parent and top-parent entities in a corporate hierarchy
  - name: Combined
    description: Resolve an entity and run a follow-up enrichment in one call
  - name: Alignment
    description: >-
      Link a CRM record to a Kernel entity and run the full cleaning pass in one
      call
  - name: LinkedIn Lookup
    description: Provisional LinkedIn company match jobs (not Kernel-verified)
  - name: Data feedback
    description: Open and manage data feedback tickets for CRM accounts
paths:
  /v1/feedback:
    get:
      tags:
        - Data feedback
      summary: List data feedback
      description: Lists data feedback tickets for your organization.
      operationId: listFeedback
      parameters:
        - name: status
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/FeedbackStatus'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
      responses:
        '200':
          description: Feedback tickets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListFeedbackResponse'
        '401':
          description: Missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Data feedback is not available
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    FeedbackStatus:
      type: string
      enum:
        - received
        - in_review
        - on_hold
        - resolved
        - resolved_not_for_kernel
    ListFeedbackResponse:
      type: object
      required:
        - data
        - total
        - limit
        - offset
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/FeedbackTicket'
        total:
          type: integer
        limit:
          type: integer
        offset:
          type: integer
    Error:
      required:
        - error
      type: object
      properties:
        error:
          description: Error description.
          type: string
          example: Entity not found
    FeedbackTicket:
      type: object
      required:
        - id
        - status
        - category
        - external_id
        - kernel_id
        - field
        - current_value
        - expected_value
        - comment
        - evidence_url
        - created_at
        - resolved_at
        - account
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/FeedbackStatus'
        category:
          type:
            - string
            - 'null'
        external_id:
          type:
            - string
            - 'null'
        kernel_id:
          type:
            - string
            - 'null'
        field:
          type:
            - string
            - 'null'
        current_value:
          type:
            - string
            - 'null'
        expected_value:
          type:
            - string
            - 'null'
        comment:
          type:
            - string
            - 'null'
        evidence_url:
          type:
            - string
            - 'null'
        created_at:
          type: string
          format: date-time
        resolved_at:
          type:
            - string
            - 'null'
          format: date-time
        account:
          type: object
          required:
            - trading_name
            - legal_name
          properties:
            trading_name:
              type:
                - string
                - 'null'
            legal_name:
              type:
                - string
                - 'null'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Include your API key in the x-api-key header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.