> ## 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 (paginated) [OSS + Cloud] ## OpenAPI ````yaml /api-reference/openapi.json post /api/v2/memory/get openapi: 3.1.0 info: title: EverOS Cloud Memory API version: 2.0.0 license: name: Apache-2.0 identifier: Apache-2.0 contact: name: EverMind AI email: service@evermind.ai url: https://github.com/EverMind-AI/everos-cloud-sdk-python description: >- Official Python client for the EverOS Cloud Memory API. Add, search, retrieve, and manage long-term memory for your AI applications over a typed interface (pydantic v2, with full type hints). Install and usage guides: https://github.com/EverMind-AI/everos-cloud-sdk-python servers: - url: https://api.evermind.ai description: Production security: - BearerAuth: [] paths: /api/v2/memory/get: post: tags: - Memory summary: Get memories (paginated) [OSS + Cloud] operationId: getMemory requestBody: content: application/json: schema: $ref: '#/components/schemas/GetInput' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SuccessEnvelope_GetData_' '401': description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/GatewayError' '403': description: Authenticated but not permitted for this resource. content: application/json: schema: $ref: '#/components/schemas/GatewayError' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit or quota exceeded. content: application/json: schema: $ref: '#/components/schemas/GatewayError' components: schemas: GetInput: properties: app_id: type: string title: App Id default: default project_id: type: string title: Project Id default: default user_id: anyOf: - type: string - type: 'null' title: User Id agent_id: anyOf: - type: string - type: 'null' title: Agent Id memory_type: type: string enum: - episode - profile - agent_case - agent_skill title: Memory Type page: type: integer minimum: 1 title: Page default: 1 page_size: type: integer maximum: 100 minimum: 1 title: Page Size default: 20 sort_by: type: string enum: - timestamp - updated_at title: Sort By default: timestamp sort_order: type: string enum: - asc - desc title: Sort Order default: desc filters: anyOf: - $ref: '#/components/schemas/FilterNode' - type: 'null' additionalProperties: false type: object required: - memory_type title: GetInput example: memory_type: episode page: 1 page_size: 20 sort_order: desc SuccessEnvelope_GetData_: properties: request_id: type: string title: Request Id description: Request trace id (peer to data) data: $ref: '#/components/schemas/GetData' description: Endpoint-defined business result type: object required: - request_id - data title: SuccessEnvelope[GetData] GatewayError: type: object additionalProperties: true description: >- Gateway error body. NOTE: shape is not yet uniform across auth/quota/ rate-limit paths — treat fields as best-effort. Commonly includes a `code`/`message` (flat) or an `error` object/string with a `message`. title: GatewayError HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError FilterNode: properties: AND: anyOf: - items: $ref: '#/components/schemas/FilterNode' type: array - type: 'null' title: And OR: anyOf: - items: $ref: '#/components/schemas/FilterNode' type: array - type: 'null' title: Or additionalProperties: true type: object title: FilterNode description: |- One Filters DSL node — recursive ``AND`` / ``OR`` arrays plus arbitrary scalar field conditions at the same level. GetData: properties: episodes: items: $ref: '#/components/schemas/EpisodeItem' type: array title: Episodes profiles: items: $ref: '#/components/schemas/ProfileItem' type: array title: Profiles agent_cases: items: $ref: '#/components/schemas/AgentCaseItem' type: array title: Agent Cases agent_skills: items: $ref: '#/components/schemas/AgentSkillItem' type: array title: Agent Skills total_count: type: integer title: Total Count default: 0 count: type: integer title: Count default: 0 type: object title: GetData ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError EpisodeItem: properties: id: type: string title: Id app_id: type: string title: App Id project_id: type: string title: Project Id user_id: anyOf: - type: string - type: 'null' title: User Id session_id: anyOf: - type: string - type: 'null' title: Session Id timestamp: type: string format: date-time title: Timestamp sender_ids: items: type: string type: array title: Sender Ids summary: type: string title: Summary subject: type: string title: Subject episode: type: string title: Episode type: type: string title: Type atomic_facts: items: $ref: '#/components/schemas/AtomicFactItem' type: array title: Atomic Facts type: object required: - id - app_id - project_id - timestamp - summary - subject - episode - type title: EpisodeItem ProfileItem: properties: id: type: string title: Id app_id: type: string title: App Id project_id: type: string title: Project Id user_id: type: string title: User Id profile_data: additionalProperties: true type: object title: Profile Data type: object required: - id - app_id - project_id - user_id title: ProfileItem AgentCaseItem: properties: id: type: string title: Id app_id: type: string title: App Id project_id: type: string title: Project Id agent_id: type: string title: Agent Id session_id: type: string title: Session Id task_intent: type: string title: Task Intent approach: type: string title: Approach quality_score: type: number title: Quality Score key_insight: anyOf: - type: string - type: 'null' title: Key Insight timestamp: type: string format: date-time title: Timestamp type: object required: - id - app_id - project_id - agent_id - session_id - task_intent - approach - quality_score - timestamp title: AgentCaseItem AgentSkillItem: properties: id: type: string title: Id app_id: type: string title: App Id project_id: type: string title: Project Id agent_id: type: string title: Agent Id name: type: string title: Name description: type: string title: Description content: type: string title: Content confidence: type: number title: Confidence maturity_score: type: number title: Maturity Score source_case_ids: items: type: string type: array title: Source Case Ids type: object required: - id - app_id - project_id - agent_id - name - description - content - confidence - maturity_score title: AgentSkillItem AtomicFactItem: properties: id: type: string title: Id content: type: string title: Content type: object required: - id - content title: AtomicFactItem description: |- Atomic fact nested in an episode. Spec appendix E references it but does not enumerate its fields — minimal shape until the contract is detailed. securitySchemes: BearerAuth: type: http scheme: bearer description: 'API key issued by EverOS, sent as `Authorization: Bearer `.' ````