> For the complete documentation index, see [llms.txt](https://docs.ibexa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ibexa.ai/developers/rest-api/conversations/list-conversations.md).

# List Conversations

List conversations for the current user.

Returns conversations created by the current user within their organisation. Results are paginated and ordered by most recent first. State/messages are not included in list response for performance.

```json
{"openapi":"3.1.0","info":{"title":"Ibexa Agentic Marketing Platform","version":"0.1.0"},"security":[{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"/api/v1/login/access-token"}}}},"schemas":{"ConversationListResponseSchema":{"properties":{"conversations":{"items":{"$ref":"#/components/schemas/ConversationListItemResponseSchema"},"type":"array","title":"Conversations"},"total_count":{"type":"integer","title":"Total Count"}},"type":"object","required":["conversations","total_count"],"title":"ConversationListResponseSchema","description":"Pydantic schema for conversation list response."},"ConversationListItemResponseSchema":{"properties":{"id":{"type":"integer","title":"Id"},"agent_id":{"type":"integer","title":"Agent Id"},"created_by":{"type":"string","format":"uuid","title":"Created By"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"feedback_rate":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Feedback Rate"},"parent_conversation_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Conversation Id","description":"ID of the parent conversation when this is a sub-agent conversation, otherwise null."}},"type":"object","required":["id","agent_id","created_by"],"title":"ConversationListItemResponseSchema","description":"Pydantic schema for conversation list item response (without state)."}}},"paths":{"/api/v1/conversations/":{"get":{"tags":["conversations","public"],"summary":"List Conversations","description":"List conversations for the current user.\n\nReturns conversations created by the current user within their organisation.\nResults are paginated and ordered by most recent first.\nState/messages are not included in list response for performance.","operationId":"conversations-list_conversations","parameters":[{"name":"skip","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of records to skip","default":0,"title":"Skip"},"description":"Number of records to skip"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of conversations to return","default":25,"title":"Limit"},"description":"Maximum number of conversations to return"},{"name":"agent","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Filter conversations by agent ID (optional)","title":"Agent"},"description":"Filter conversations by agent ID (optional)"},{"name":"subject","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":3,"maxLength":255},{"type":"null"}],"description":"Filter conversations by subject (optional, case-insensitive, partial match)","title":"Subject"},"description":"Filter conversations by subject (optional, case-insensitive, partial match)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationListResponseSchema"}}}},"401":{"description":"User not authenticated","content":{"application/json":{}}},"403":{"description":"User lacks permission","content":{"application/json":{}}}}}}}}
```