AI Connections1

Annotation Queues7

Annotations4

Dashboards11

Datasets7

Evaluation10

Legacy2

Metric Collections3

Metrics5

Metrics Data1

Organization2

Organization API Keys5

Organization Governance Policies4

Organization Invitations4

Organization Members3

Organization Permissions1

Organization Policies4

Organization Roles4

Project API Keys5

Project Invitations4

Project Members3

Project Permissions1

Project Policies4

Project Roles4

Projects5

Prompt12

Risk Assessments2

Threads2

Tracing5

Annotations

List Annotations

Retrieves a paginated list of annotations from your Confident AI project. Annotations are user feedback on traces, spans, or threads that include ratings, expected outputs/outcomes, and explanations.

Use query parameters to filter annotations by trace UUID, span UUID, thread ID, type, or rating range. Results are returned in descending order by creation date with pagination support.

get/v1/annotations

Query parameters

traceUuidstring

Filter annotations by trace UUID.

spanUuidstring

Filter annotations by span UUID.

threadIdstring

Filter annotations by thread ID.

type'THUMBS_RATING' | 'FIVE_STAR_RATING'

Filter annotations by type.

minRatingstring

Filter annotations with minimum rating (inclusive).

maxRatingstring

Filter annotations with maximum rating (inclusive).

pageinteger

This specifies the page number of the annotations to return. Defaulted to 1.

pageSizeinteger

This specifies the maximum number of annotations per page. Defaulted to 25.

startstring date-time

This filters for annotations created after the specified start datetime. Defaulted to 30 days ago.

endstring date-time

This filters for annotations created before the specified end datetime. Defaulted to the current time.

sortBy'createdAt'

This determines the field to sort by. Defaulted to createdAt.

ascending'true' | 'false'

This determines if the field specified in sortBy should be in ascending order. Defaults to false.

Headers

CONFIDENT_API_KEYstring required

The API key of your Confident AI project.

Response

Successfully retrieved list of annotations

successboolean required

Indicates if the request was successful.

Changes

Changed in 3 of the 54 revisions of this API.58

Apr 28, 202675ac46e3e4642See the full diff
- ○
  added the required property //////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
Apr 28, 20260b1be348f19f34See the full diff
- ▲
  the response property /// became nullable for the status
  response-property-became-nullable
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  response property data/annotations/items/userEmail deprecated
  response-property-deprecated
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
Mar 3, 2026ecbd1848809222See the full diff
- ▲
  removed the enum value asc from the query request parameter ascending
  request-parameter-enum-value-removed
- ▲
  removed the enum value desc from the query request parameter ascending
  request-parameter-enum-value-removed
- ○
  added the new enum value false to the query request parameter ascending
  request-parameter-enum-value-added
- ○
  added the new enum value true to the query request parameter ascending
  request-parameter-enum-value-added

Of the 54 revisions, 3 have no diff computed.

Full history