---
title: "Submit structured feedback on your rating"
method: PATCH
path: "/documents/{id}/rating/feedback"
tags: ["Documents"]
---

# Submit structured feedback on your rating

`PATCH /documents/{id}/rating/feedback`

## Request

- Base URL: `https://api.bankstatemently.com/v1`
- URL: `https://api.bankstatemently.com/v1/documents/{id}/rating/feedback`
- Auth: API key in header `X-API-Key`

Adds feedback (categories and/or free text) to the caller's own existing rating, at any rating. Rate limit: 10 requests per minute.

## Path parameters

- `id` string, uuid, required

## Request body

- object: At least one of `categories` or `feedback` is required.
  - `categories` string[]
  - `feedback` string

## Response `200`

Feedback stored.

- object
  - `data` object
    - `categories` string[]
    - `feedback` string, nullable

## Other responses

- `400`: At least one of categories or feedback is required.
- `401`: Authentication failed, API key revoked, or API key expired.
- `404`: The caller has no rating of their own for this document yet.
- `429`: Too many requests. Wait the number of seconds indicated by the `Retry-After` header.
- `500`: An unexpected server error occurred.

---

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