Skip to main content
GET
/
records
/
{recordId}
/
annotations
JavaScript
import Scorecard from 'scorecard-ai';

const client = new Scorecard({
  apiKey: 'My API Key',
});

const annotations = await client.records.annotations.list('777');

console.log(annotations.data);
{
  "data": [
    {
      "id": "1",
      "recordId": "777",
      "spanId": null,
      "rating": true,
      "comment": "Great response!",
      "userId": "user_abc123",
      "createdAt": "2026-03-01T12:00:00.000Z"
    },
    {
      "id": "2",
      "recordId": "777",
      "spanId": "span_xyz",
      "rating": false,
      "comment": "This answer was incorrect for the given context.",
      "userId": "user_def456",
      "createdAt": "2026-03-02T15:30:00.000Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
recordId
string
required

The ID of the Record to list annotations for.

Example:

"777"

Response

Successfully retrieved list of Annotations for the Record.

​
data
object[]
required