> ## Documentation Index > Fetch the complete documentation index at: https://docs.recallrai.com/llms.txt > Use this file to discover all available pages before exploring further. # List User Memories > List all memories for a user with version history and relationships. Retrieve extracted memories with support for category filtering, session filtering, and metadata queries. Always returns only current (latest) versions of memories. Optionally includes version history and connected memory relationships. **Path Parameters:** - `custom_user_id` (str): Unique identifier for the user **Query Parameters:** - `categories` (List[str]): Filter by memory categories. Optional - `offset` (int): Number of records to skip for pagination. Default: 0 - `limit` (int): Maximum records to return. Range: 1-200. Default: 20 - `session_id_filter` (List[str]): Filter by specific session IDs. Optional - `session_metadata_filter` (str): JSON string filter for session metadata (supports nested JSON matching). Optional - `include_previous_versions` (bool): Include full version history for each memory. Default: true - `include_connected_memories` (bool): Include related memories via relationships. Default: true **Returns:** - `items` (List[UserMemoryItem]): List of memory objects with categories, versions, and relationships - `total` (int): Total number of memories matching the filters - `has_more` (bool): Whether more memories are available beyond the current page ## OpenAPI ````yaml https://api.recallrai.com/api/openapi.json get /api/v1/users/{custom_user_id}/memories openapi: 3.1.0 info: title: api-backend description: This powers the Recallr AI API Backend version: 0.1.0 servers: - url: https://api.recallrai.com description: Production server security: [] paths: /api/v1/users/{custom_user_id}/memories: get: tags: - Memories summary: List User Memories description: >- List all memories for a user with version history and relationships. Retrieve extracted memories with support for category filtering, session filtering, and metadata queries. Always returns only current (latest) versions of memories. Optionally includes version history and connected memory relationships. **Path Parameters:** - `custom_user_id` (str): Unique identifier for the user **Query Parameters:** - `categories` (List[str]): Filter by memory categories. Optional - `offset` (int): Number of records to skip for pagination. Default: 0 - `limit` (int): Maximum records to return. Range: 1-200. Default: 20 - `session_id_filter` (List[str]): Filter by specific session IDs. Optional - `session_metadata_filter` (str): JSON string filter for session metadata (supports nested JSON matching). Optional - `include_previous_versions` (bool): Include full version history for each memory. Default: true - `include_connected_memories` (bool): Include related memories via relationships. Default: true **Returns:** - `items` (List[UserMemoryItem]): List of memory objects with categories, versions, and relationships - `total` (int): Total number of memories matching the filters - `has_more` (bool): Whether more memories are available beyond the current page operationId: list_user_memories_api_v1_users__custom_user_id__memories_get parameters: - name: custom_user_id in: path required: true schema: type: string title: Custom user ID - name: categories in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Categories to filter by title: Categories description: Categories to filter by - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 20 title: Limit - name: session_id_filter in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Filter by specific session IDs title: Session Id Filter description: Filter by specific session IDs - name: session_metadata_filter in: query required: false schema: anyOf: - type: string - type: 'null' description: JSON string filter for session metadata title: Session Metadata Filter description: JSON string filter for session metadata - name: include_previous_versions in: query required: false schema: type: boolean description: Include full version history for each memory default: true title: Include Previous Versions description: Include full version history for each memory - name: include_connected_memories in: query required: false schema: type: boolean description: Include connected memories default: true title: Include Connected Memories description: Include connected memories - name: X-Recallr-Project-Id in: header required: true schema: type: string format: uuid title: X-Recallr-Project-Id - name: X-Recallr-Api-Key in: header required: true schema: type: string title: X-Recallr-Api-Key responses: '200': description: Memories listed successfully content: application/json: schema: $ref: '#/components/schemas/ListUserMemoriesResponse' '400': description: Invalid categories provided '401': description: Authentication required '404': description: User not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal server error components: schemas: ListUserMemoriesResponse: properties: items: items: $ref: '#/components/schemas/UserMemoryItem' type: array title: Items total: type: integer title: Total has_more: type: boolean title: Has More type: object required: - items - total - has_more title: ListUserMemoriesResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError UserMemoryItem: properties: memory_id: type: string format: uuid title: Memory Id categories: items: type: string type: array title: Categories content: type: string title: Content event_date_start: type: string format: date-time title: Event Date Start event_date_end: type: string format: date-time title: Event Date End created_at: type: string format: date-time title: Created At expired_at: anyOf: - type: string format: date-time - type: 'null' title: Expired At expiration_reason: anyOf: - type: string - type: 'null' title: Expiration Reason version_number: type: integer title: Version Number total_versions: type: integer title: Total Versions has_previous_versions: type: boolean title: Has Previous Versions previous_versions: anyOf: - items: $ref: '#/components/schemas/MemoryVersionInfo' type: array - type: 'null' title: Previous Versions connected_memories: anyOf: - items: $ref: '#/components/schemas/MemoryRelationship' type: array - type: 'null' title: Connected Memories merge_conflict_in_progress: type: boolean title: Merge Conflict In Progress merge_conflict_id: anyOf: - type: string format: uuid - type: 'null' title: Merge Conflict Id session_id: type: string title: Session Id type: object required: - memory_id - categories - content - event_date_start - event_date_end - created_at - version_number - total_versions - has_previous_versions - previous_versions - connected_memories - merge_conflict_in_progress - session_id title: UserMemoryItem description: Complete memory information with all metadata ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError MemoryVersionInfo: properties: memory_id: type: string format: uuid title: Memory Id version_number: type: integer title: Version Number content: type: string title: Content event_date_start: type: string format: date-time title: Event Date Start event_date_end: type: string format: date-time title: Event Date End created_at: type: string format: date-time title: Created At expired_at: type: string format: date-time title: Expired At expiration_reason: type: string title: Expiration Reason merge_conflict_id: anyOf: - type: string format: uuid - type: 'null' title: Merge Conflict Id type: object required: - memory_id - version_number - content - event_date_start - event_date_end - created_at - expired_at - expiration_reason title: MemoryVersionInfo description: Information about a specific version of a memory MemoryRelationship: properties: memory_id: type: string format: uuid title: Memory Id content: type: string title: Content type: object required: - memory_id - content title: MemoryRelationship description: Connected memory information ````