Get Annotation

GET

https://api.confident-ai.com/v1/annotations/:annotationId

Retrieves a specific annotation by its unique ID. Returns the complete annotation details including rating, type, expected output/outcome, explanation, and associated trace/span/thread identifiers.

This endpoint verifies that the annotation belongs to your project before returning it.

1	{
2	"success": true,
3	"data": {
4	"annotation": {
5	"id": "annotation-uuid",
6	"rating": 1,
7	"type": "THUMBS_RATING",
8	"name": "Quality Check",
9	"expectedOutput": "Provide clear password reset instructions",
10	"explanation": "Response correctly guides user through password reset",
11	"createdAt": "2025-11-12T10:30:00Z",
12	"traceUuid": "trace-uuid-1",
13	"user": {
14	"id": "user-uuid-1",
15	"email": "user1@example.com",
16	"name": "User One",
17	"image": "https://example.com/user1.png"
18	}
19	}
20	}
21	}

1	{
2	"success": true,
3	"data": {
4	"annotation": {
5	"id": "annotation-uuid",
6	"rating": 1,
7	"type": "THUMBS_RATING",
8	"name": "Quality Check",
9	"expectedOutput": "Provide clear password reset instructions",
10	"explanation": "Response correctly guides user through password reset",
11	"createdAt": "2025-11-12T10:30:00Z",
12	"traceUuid": "trace-uuid-1",
13	"user": {
14	"id": "user-uuid-1",
15	"email": "user1@example.com",
16	"name": "User One",
17	"image": "https://example.com/user1.png"
18	}
19	}
20	}
21	}

Get Annotation

Get Annotation

Path parameters

Headers

Response

Errors

Path parameters

Headers

Response

Errors

$	curl https://api.confident-ai.com/v1/annotations/annotationId \
>	-H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"