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

# List all memories

> Retrieves a paginated list of memories for the memory store



## OpenAPI

````yaml get /v2/memory-stores/{memory_store_key}/memories
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: Files
    description: File upload and retrieval operations.
  - name: FilesService
  - name: Projects
    description: Projects organize resources within a workspace
  - name: ProjectsService
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: SkillsService
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
  - name: ReportingService
    description: |-
      ReportingService exposes a single QueryReport RPC that maps allowlisted
       analytics payloads onto safe rollup queries. Callers never send SQL;
       the backend picks the rollup family and grain from the metric
       catalogue, the requested range, and the requested grouping.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/memory-stores/{memory_store_key}/memories:
    get:
      tags:
        - Memory Stores
      summary: List all memories
      description: Retrieves a paginated list of memories for the memory store
      operationId: GetAllMemories
      parameters:
        - schema:
            type: string
            description: The unique key identifier of the memory store
          required: true
          description: The unique key identifier of the memory store
          name: memory_store_key
          in: path
        - schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 10
            description: >-
              A limit on the number of objects to be returned. Limit can range
              between 1 and 50, and the default is 10
          required: false
          description: >-
            A limit on the number of objects to be returned. Limit can range
            between 1 and 50, and the default is 10
          name: limit
          in: query
        - schema:
            type: string
            description: >-
              A cursor for use in pagination. `starting_after` is an object ID
              that defines your place in the list. For instance, if you make a
              list request and receive 20 objects, ending with
              `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
              `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page
              of the list.
          required: false
          description: >-
            A cursor for use in pagination. `starting_after` is an object ID
            that defines your place in the list. For instance, if you make a
            list request and receive 20 objects, ending with
            `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
            `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page
            of the list.
          name: starting_after
          in: query
        - schema:
            type: string
            description: >-
              A cursor for use in pagination. `ending_before` is an object ID
              that defines your place in the list. For instance, if you make a
              list request and receive 20 objects, starting with
              `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
              `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous
              page of the list.
          required: false
          description: >-
            A cursor for use in pagination. `ending_before` is an object ID that
            defines your place in the list. For instance, if you make a list
            request and receive 20 objects, starting with
            `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include
            `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous
            page of the list.
          name: ending_before
          in: query
        - schema:
            type: string
            description: Search query to filter memories by entity_id
          required: false
          description: Search query to filter memories by entity_id
          name: q
          in: query
      responses:
        '200':
          description: Successfully retrieved the list of memories.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                          description: >-
                            Unique identifier for the memory. This is
                            automatically generated by the system.
                        entity_id:
                          type: string
                          minLength: 1
                          maxLength: 64
                          pattern: ^[A-Za-z0-9]+(?:[_-][A-Za-z0-9]+)*$
                          deprecated: true
                          description: >-
                            Customer provided entity ID for the memory. This is
                            used to link the memory to a specific
                            user/company/session/etc. Has to be unique within
                            the memory store.
                        created:
                          type: string
                        updated:
                          type: string
                        created_by_id:
                          type:
                            - string
                            - 'null'
                        updated_by_id:
                          type:
                            - string
                            - 'null'
                        store_id:
                          type: string
                        workspace_id:
                          type: string
                        documents_count:
                          type: number
                          description: The number of memories in the entity
                      required:
                        - _id
                        - entity_id
                        - created
                        - updated
                        - store_id
                        - workspace_id
                        - documents_count
                  has_more:
                    type: boolean
                required:
                  - object
                  - data
                  - has_more
        '401':
          description: Unauthorized - Bearer token is missing or invalid
        '403':
          description: Forbidden - Insufficient permissions to access memories
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````