Skip to main content
GET
https://api.tracelm.ai
/
api
/
v1
/
conversations
List Conversations
curl --request GET \
  --url https://api.tracelm.ai/api/v1/conversations
{
  "conversations": [
    {}
  ],
  "total": 123,
  "page": 123,
  "page_size": 123
}
Returns a paginated list of conversations with optional filtering.

​
Query Parameters

​
project_id
string
Filter by project ID
​
user_id
string
Filter by user ID
​
has_context_failures
boolean
Filter conversations with context failures
​
start_date
string
Filter conversations started after this date (ISO 8601)
​
end_date
string
Filter conversations started before this date (ISO 8601)
​
page
integer
default:"1"
Page number for pagination
​
page_size
integer
default:"50"
Number of conversations per page (max 100)

​
Response

​
conversations
array
Array of conversation objects with summary information
​
total
integer
Total number of conversations matching the filters
​
page
integer
Current page number
​
page_size
integer
Number of conversations per page

​
Example

curl -X GET "https://api.tracelm.ai/api/v1/conversations?has_context_failures=true&page=1" \
  -H "X-API-Key: $TRACELM_API_KEY"

​
Response

{
  "conversations": [
    {
      "id": "conv_456",
      "user_id": "user_123",
      "task_count": 3,
      "trace_count": 15,
      "context_failure_count": 2,
      "started_at": "2024-01-15T10:00:00Z",
      "last_activity_at": "2024-01-15T10:45:00Z"
    }
  ],
  "total": 25,
  "page": 1,
  "page_size": 50
}