---
title: "List project feedback"
method: GET
path: "/v1/projects/{projectId}/feedback"
tags: ["Feedback"]
---

# List project feedback

`GET /v1/projects/{projectId}/feedback`

## Request

- Base URL: `https://api.ybug.io`
- URL: `https://api.ybug.io/v1/projects/{projectId}/feedback`
- Auth: HTTP bearer

Retrieves a paginated list of feedback items captured on the project. Results default to ascending creation order and can be sorted via the `order_by` parameter.
Optional `assignee[]` filters restrict results to the OR of selected assignees or unassigned (pass a special value `none`).
Optional `tag[]` filters restrict results to feedback that has at least one of the given tags (OR). Each value is a tag name or tag UUID for the project's team.
Optional `status[]` filters restrict results to feedback in any of the given statuses (OR). Each value is a `status_id` for the project's team; the comma-separated `status=1,2` form works too.

## Response `200`

Successful retrieval of feedback for the project.

- FeedbackList
  - `feedback` Feedback[]
    - `id` string
    - `feedback_id` integer: Public shareable feedback identifier.
    - `project_id` string
    - `title` string
    - `reporter` object: Information about the feedback reporter.
    - `assignee` object, nullable: Assigned project member (if any).
      - `id` string, uuid: Public user identifier (UUID).
      - `name` string
    - `user_data` object, nullable: Arbitrary user-provided data associated with the feedback.
      - `plan` string: Example custom key. Actual keys are user-defined.
      - `user_id` integer: Example custom key. Actual keys are user-defined.
    - `url` string, uri
    - `description` string
    - `rating` integer, nullable
    - `rating_type` string, nullable
    - `net_promoter_score` integer, nullable
    - `priority_id` integer
    - `priority` string
    - `type_id` integer
    - `type` string
    - `status_id` integer: The status of the feedback, as a `status_id` of the project's team. See the `status_id` request field on "Update feedback" for how the id ranges work.
    - `status` string
    - `source_type` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `comment_count` integer: Number of comments on this feedback item.
    - `tags` Tag[]: Tags assigned to this feedback item.
      - `id` string, uuid
      - `name` string
    - `custom_fields` CustomField[]: Custom fields configured for the feedback item project.
      - `id` string, uuid
      - `name` string
      - `value` union: Custom field value. Null when no value was submitted for this feedback item.
        - string
        - number
        - boolean
    - `client_context` object
      - `browser` string
      - `browser_version` string
      - `os_name` string
      - `os_version` string
      - `device_type` string
      - `screen_width` integer
      - `screen_height` integer
      - `viewport_width` integer
      - `viewport_height` integer
      - `screen_pixel_depth` integer
      - `screen_pixel_ratio` number
      - `referrer` string
      - `geo` object
        - `country_code` string
        - `region` string
        - `city` string
    - `screenshot_url` string, uri, nullable
    - `video_url` string, uri, nullable
    - `console_log_url` string, uri, nullable
  - `meta` PaginationMeta: Metadata for the paginated response.
    - `total_count` integer: The total number of items available across all pages.
    - `page` integer: The current page number being returned (starts at 1).
    - `page_size` integer: Number of items per page (25 by default, max 100).
    - `last_page` boolean: True if this is the final page of results.

## Other responses

- `400`: Bad Request. The request was invalid (e.g., missing required fields in payload).
- `401`: Unauthorized. Missing or invalid API token.
- `403`: Forbidden. The user does not have permission to access the resource, or the operation is restricted by the account plan.
- `404`: Not Found. The requested resource (team or project ID) could not be found.
- `429`: Too Many Requests. The rate limit for the client has been exceeded.
- `500`: Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.dev/ybug/apis/ybug-api.md) · [All operations](https://skmtc.dev/ybug/apis/ybug-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ybug/apis/ybug-api/revisions/50f50cb05459?raw)