---
title: "List Annotations"
method: GET
path: "/records/{recordId}/annotations"
---

# List Annotations

`GET /records/{recordId}/annotations`

List all annotations (ratings and comments) for a specific Record.

## Path parameters

- `recordId` string, required

## Response `200`

Successfully retrieved list of Annotations for the Record.

- object
  - `data` Annotation[], required
    - `id` string, required — The ID of the Annotation.
    - `recordId` string, required — The ID of the Record this Annotation belongs to.
    - `spanId` string, nullable, required — Optional span ID linking this annotation to a specific span.
    - `rating` boolean, nullable, required — The rating of the annotation: true (positive), false (negative), or null (no rating).
    - `comment` string, nullable, required — An optional text comment for the annotation.
    - `userId` string, required — The ID of the user who created the annotation.
    - `createdAt` string, required — The ISO 8601 timestamp when the annotation was created.

## Other responses

- `401` — Error indicating that the request is not authenticated.
- `500` — An internal service error indicating an issue with the Scorecard service.

## Changes

- **2026-03-10** `fa56fcaa5a33` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/records/:recordId/annotations/get.md)

---

[API](https://skmtc.dev/scorecard-ai/apis/scorecard-api.md) · [All operations](https://skmtc.dev/scorecard-ai/apis/scorecard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scorecard-ai/scorecard-api/revisions/121aaa257802/schema)