> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evermind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get memories

> Retrieve structured memories using filters DSL with pagination. Supports episodic_memory, profile, agent_case, and agent_skill types.

**Filters DSL**
Allowlist-based: only the following fields are processed, unknown fields are silently ignored.

| Field        | Type                           | Operators                | Description                            |
| ------------ | ------------------------------ | ------------------------ | -------------------------------------- |
| `user_id`    | string                         | eq, in                   | User ID filter (conditional required)  |
| `group_id`   | string                         | eq, in                   | Group ID filter (conditional required) |
| `session_id` | string                         | eq, in, gt, gte, lt, lte | Session ID filter                      |
| `timestamp`  | int (epoch ms/s) or ISO string | eq, gt, gte, lt, lte     | Time range filter                      |
| `AND`        | array                          | -                        | All conditions must match              |
| `OR`         | array                          | -                        | Any condition must match               |

**Operator syntax**: plain value = eq, `{"in": [...]}`, `{"gte": v, "lt": v}`


## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/memories/get
openapi: 3.1.0
info:
  title: EverOS API
  description: >-
    Enterprise-grade intelligent memory system for AI agents. Extracts,
    structures, and retrieves information from conversations.
  version: 1.0.0
  contact:
    name: EverOS Team
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
  - url: https://api.evermind.ai
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Memories
    description: Memory ingestion, retrieval, search, and deletion
  - name: Groups
    description: Group resource CRUD operations
  - name: Senders
    description: Sender resource CRUD operations
  - name: Settings
    description: Global settings management
  - name: Tasks
    description: Async task status tracking
  - name: Storage
    description: Multimodal content storage (pre-signed upload)
paths:
  /api/v1/memories/get:
    post:
      tags:
        - Memories
      summary: Get memories
      description: >-
        Retrieve structured memories using filters DSL with pagination. Supports
        episodic_memory, profile, agent_case, and agent_skill types.
      operationId: getMemories
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetMemRequest'
      responses:
        '200':
          description: Memories retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMemoriesResponse'
        '422':
          description: >-
            Validation error (invalid parameter values, business rule
            violations)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missing_scope:
                  summary: Missing required scope filter
                  value:
                    code: InvalidParameter
                    message: >-
                      filters must contain at least one of 'user_id' or
                      'group_id' at first level
                    request_id: unknown
                    timestamp: '2026-03-24T00:00:00+00:00'
                    path: /api/v1/memories/get
                invalid_memory_type:
                  summary: Invalid memory_type
                  value:
                    code: InvalidParameter
                    message: >-
                      memory_type must be one of: agent_case, agent_skill,
                      episodic_memory, profile
                    request_id: unknown
                    timestamp: '2026-03-24T00:00:00+00:00'
                    path: /api/v1/memories/get
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: Python
          source: |-
            from everos_cloud import EverOS

            client = EverOS()
            memories = client.v1.memories

            response = memories.get(
                filters={"user_id": "<string>"},
                memory_type="<string>",
                page=1,
                page_size=10
            )
            print(response)
        - lang: cURL
          source: |-
            curl --request POST \
              --url 'https://api.evermind.ai/api/v1/memories/get' \
              --header 'Authorization: Bearer <api_key>' \
              --header 'Content-Type: application/json' \
              --data '{}'
components:
  schemas:
    GetMemRequest:
      type: object
      required:
        - memory_type
        - filters
      properties:
        memory_type:
          type: string
          description: |-
            Memory type to query. Scope constraint per type:
            - episodic_memory: supports both user_id and group_id
            - profile: user_id only (group_id will return 400)
            - agent_case: user_id only (group_id will return 400)
            - agent_skill: user_id only (group_id will return 400)
          enum:
            - episodic_memory
            - profile
            - agent_case
            - agent_skill
        filters:
          type: object
          description: >-
            Filter conditions. Supported fields: user_id, group_id, session_id,
            timestamp. user_id and group_id are placed at the top level of the
            filters object. session_id and timestamp support operators (eq, in,
            gt, gte, lt, lte) and can be used inside AND/OR combinators.
          additionalProperties: true
        page:
          type: integer
          description: Page number (starts from 1)
          default: 1
          minimum: 1
        page_size:
          type: integer
          description: Items per page
          default: 20
          minimum: 1
          maximum: 100
        rank_by:
          type: string
          description: Sort field
          default: timestamp
        rank_order:
          type: string
          description: Sort order
          enum:
            - asc
            - desc
          default: desc
    GetMemoriesResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/GetMemResponse'
    ErrorResponse:
      type: object
      required:
        - code
        - message
        - timestamp
        - path
      properties:
        code:
          type: string
          description: Error code
          examples:
            - InvalidParameter
            - NotFound
            - InternalError
        message:
          type: string
          description: Error message
        request_id:
          type: string
          description: Request ID
          default: unknown
        timestamp:
          type: string
          description: ISO 8601 timestamp
        path:
          type: string
          description: Request path
    GetMemResponse:
      type: object
      properties:
        episodes:
          type: array
          items:
            $ref: '#/components/schemas/EpisodeItem'
          default: []
          description: Episodic memory items
        profiles:
          type: array
          items:
            $ref: '#/components/schemas/ProfileItem'
          default: []
          description: Profile items
        agent_cases:
          type: array
          items:
            $ref: '#/components/schemas/AgentCaseItem'
          default: []
          description: Agent case items
        agent_skills:
          type: array
          items:
            $ref: '#/components/schemas/AgentSkillItem'
          default: []
          description: Agent skill items
        total_count:
          type: integer
          description: Total records matching filters
          default: 0
        count:
          type: integer
          description: Records in current page
          default: 0
    EpisodeItem:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: MongoDB ObjectId as string
        user_id:
          description: Owner user ID
          type:
            - string
            - 'null'
        group_id:
          description: Group ID
          type:
            - string
            - 'null'
        session_id:
          description: Session identifier
          type:
            - string
            - 'null'
        timestamp:
          format: date-time
          description: Event occurrence time
          type:
            - string
            - 'null'
        participants:
          items:
            type: string
          description: Event participant names
          type:
            - array
            - 'null'
        sender_ids:
          items:
            type: string
          description: Sender IDs of event participants
          type:
            - array
            - 'null'
        summary:
          description: Memory summary
          type:
            - string
            - 'null'
        subject:
          description: Memory subject
          type:
            - string
            - 'null'
        episode:
          description: Full episodic memory text
          type:
            - string
            - 'null'
        type:
          description: Episode type
          type:
            - string
            - 'null'
        parent_type:
          description: Parent memory type
          type:
            - string
            - 'null'
        parent_id:
          description: Parent memory ID
          type:
            - string
            - 'null'
    ProfileItem:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: MongoDB ObjectId as string
        user_id:
          description: User ID
          type:
            - string
            - 'null'
        group_id:
          description: Group ID
          type:
            - string
            - 'null'
        profile_data:
          description: Profile data (explicit_info, implicit_traits)
          additionalProperties: true
          type:
            - object
            - 'null'
        scenario:
          description: 'Scenario type: solo or team'
          type:
            - string
            - 'null'
        memcell_count:
          description: Number of MemCells
          type:
            - integer
            - 'null'
    AgentCaseItem:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: MongoDB ObjectId as string
        user_id:
          description: User ID
          type:
            - string
            - 'null'
        group_id:
          description: Group ID
          type:
            - string
            - 'null'
        session_id:
          description: Session identifier
          type:
            - string
            - 'null'
        task_intent:
          description: Rewritten task intent as retrieval key
          type:
            - string
            - 'null'
        approach:
          description: Step-by-step approach with decisions and lessons
          type:
            - string
            - 'null'
        quality_score:
          description: Task completion quality score (0.0-1.0)
          type:
            - number
            - 'null'
        timestamp:
          format: date-time
          description: Task occurrence time
          type:
            - string
            - 'null'
        parent_type:
          description: Parent memory type
          type:
            - string
            - 'null'
        parent_id:
          description: Parent memory ID
          type:
            - string
            - 'null'
    AgentSkillItem:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: MongoDB ObjectId as string
        user_id:
          description: User ID
          type:
            - string
            - 'null'
        group_id:
          description: Group ID
          type:
            - string
            - 'null'
        cluster_id:
          description: MemScene cluster ID
          type:
            - string
            - 'null'
        name:
          description: Skill name
          type:
            - string
            - 'null'
        description:
          description: What this skill does and when to use it
          type:
            - string
            - 'null'
        content:
          description: Full skill content
          type:
            - string
            - 'null'
        confidence:
          description: Confidence score (0.0-1.0)
          type:
            - number
            - 'null'
        maturity_score:
          description: Maturity score (0.0-1.0)
          type:
            - number
            - 'null'
        source_case_ids:
          type: array
          items:
            type: string
          description: Source AgentCase IDs
          default: []
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      x-default: Bearer <api_key>
      description: >-
        Bearer authentication header of the form Bearer 'api_key', obtain your
        API key from [everos.evermind.ai](https://everos.evermind.ai).

````