curl --request GET \
--url https://api.example.com/api/v2/projects/{project_id}/sessions[
{
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_time": "<string>",
"custom_metadata": {},
"messages": [
{
"message_type": "<string>",
"completion_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"environment": "<string>",
"provider_name": "<string>",
"model_name": "<string>",
"input_variables": {},
"prompt": [
{
"content": "<string>",
"role": "user"
}
],
"prompt_template_name": "<string>",
"response": "<string>",
"customer_feedback": {},
"evaluation_results": [
{
"name": "<string>",
"manual_score": "<unknown>",
"auto_eval_score": "<unknown>"
}
],
"client_evaluation_results": [
{
"name": "<string>",
"value": "<unknown>"
}
],
"notes": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"content": "<string>",
"created_at": "<string>",
"created_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email_address": "<string>",
"first_name": "<string>",
"last_name": "<string>"
}
}
],
"trace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"format_version": 123,
"start_time": "<string>",
"end_time": "<string>"
}
]
}
]Retrieve sessions with their completions, ordered by most recent first. Use to display conversation history or analyze LLM usage patterns. Traces are referenced by ID but not expanded.
Filter by custom metadata using query parameters prefixed with custom_metadata. (e.g., custom_metadata.user_id=123).
Prefer using the /search/sessions endpoint for more advanced filtering.
curl --request GET \
--url https://api.example.com/api/v2/projects/{project_id}/sessions[
{
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"start_time": "<string>",
"custom_metadata": {},
"messages": [
{
"message_type": "<string>",
"completion_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"environment": "<string>",
"provider_name": "<string>",
"model_name": "<string>",
"input_variables": {},
"prompt": [
{
"content": "<string>",
"role": "user"
}
],
"prompt_template_name": "<string>",
"response": "<string>",
"customer_feedback": {},
"evaluation_results": [
{
"name": "<string>",
"manual_score": "<unknown>",
"auto_eval_score": "<unknown>"
}
],
"client_evaluation_results": [
{
"name": "<string>",
"value": "<unknown>"
}
],
"notes": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"content": "<string>",
"created_at": "<string>",
"created_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email_address": "<string>",
"first_name": "<string>",
"last_name": "<string>"
}
}
],
"trace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"format_version": 123,
"start_time": "<string>",
"end_time": "<string>"
}
]
}
]