---
title: "Read your own rating for a document"
method: GET
path: "/documents/{id}/rating"
tags: ["Documents"]
---

# Read your own rating for a document

`GET /documents/{id}/rating`

## Request

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

Returns the caller's own stored rating for this document, or `data: null` if the caller has not rated it yet. Rate limit: 10 requests per minute.

## Path parameters

- `id` string, uuid, required

## Response `200`

The caller's own rating, or null.

- object
  - `data` object, nullable: null when the caller has not rated this document.
    - `rating` integer
    - `hasFeedback` boolean: Whether structured or free-text feedback is stored for this rating.
    - `hasUseCase` boolean: Whether use-case tags are stored for this rating.

## Other responses

- `401`: Authentication failed, API key revoked, or API key expired.
- `404`: Document not found.
- `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)