Python
import requests
url = "https://app.langwatch.ai/api/annotations"
headers = {"X-Auth-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Auth-Token': '<api-key>'}};
fetch('https://app.langwatch.ai/api/annotations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://app.langwatch.ai/api/annotations \
--header 'X-Auth-Token: <api-key>'[
{
"id": "<string>",
"projectId": "<string>",
"traceId": "<string>",
"comment": "<string>",
"isThumbsUp": true,
"userId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"email": "<string>"
}
]{
"error": 123,
"message": "<string>"
}Annotations
Get annotations
Returns all annotations for project
GET
/
api
/
annotations
Python
import requests
url = "https://app.langwatch.ai/api/annotations"
headers = {"X-Auth-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Auth-Token': '<api-key>'}};
fetch('https://app.langwatch.ai/api/annotations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://app.langwatch.ai/api/annotations \
--header 'X-Auth-Token: <api-key>'[
{
"id": "<string>",
"projectId": "<string>",
"traceId": "<string>",
"comment": "<string>",
"isThumbsUp": true,
"userId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"email": "<string>"
}
]{
"error": 123,
"message": "<string>"
}Authorizations
Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.
Query Parameters
Which comments to return. Omitted returns every comment, including the ones left on a span, a field, an attribute or a message; "trace" returns only the comments about whole traces.
Available options:
trace, all Response
Annotation response
The ID of the annotation
The ID of the project
The ID of the trace
The comment of the annotation
The thumbs up status of the annotation
The ID of the user
The created at of the annotation
The updated at of the annotation
The email of the user
Last modified on March 25, 2026
Was this page helpful?