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

# Get Memories

## Image Memories

Responses may include image memories alongside text memories. Image memories include additional fields:

* `content_type: "image"` — identifies this as an image memory
* `image_url` — a signed URL to view the image (expires after 4 hours)
* `image_description` — AI-generated description of the image content

### Example Response

```json theme={null}
{
  "data": [
    {
      "id": "user-id-uuid",
      "text": "User prefers dark mode in all applications",
      "content_type": "text",
      "metadata": {
        "text": "User prefers dark mode in all applications",
        "createdAt": "2026-04-01T10:00:00Z",
        "bucketId": 65,
        "bucketName": "General"
      }
    },
    {
      "id": "user-id-uuid-2",
      "text": "A whiteboard diagram showing the auth flow with three microservices.",
      "content_type": "image",
      "image_url": "https://memoryplugin.com/storage/v1/object/sign/memory-images/...",
      "image_description": "A whiteboard diagram showing the auth flow with three microservices.",
      "metadata": {
        "text": "A whiteboard diagram showing the auth flow with three microservices.",
        "createdAt": "2026-04-06T10:30:00Z",
        "bucketId": 65,
        "bucketName": "General"
      }
    }
  ],
  "count": 2
}
```

<Note>
  Image URLs are temporary signed URLs that expire after 4 hours. If you need to access an image after the URL has expired, make another API request to get a fresh URL.
</Note>


## OpenAPI

````yaml GET /api/memory
openapi: 3.1.0
info:
  title: MemoryPlugin
  version: 1.0.0
  description: API for managing and querying user memories
servers:
  - url: https://www.memoryplugin.com
security: []
paths:
  /api/memory:
    get:
      summary: Query or retrieve memories.
      operationId: GetMemories
      parameters:
        - name: query
          in: query
          schema:
            type: string
          description: >-
            Search query for memories. You will receive the 5 most relevant
            memories.
        - name: all
          in: query
          schema:
            type: boolean
          description: Fetch all memories
        - name: latest
          in: query
          schema:
            type: boolean
          description: Fetch latest memories
        - name: count
          in: query
          schema:
            type: integer
            default: 10
          description: >-
            Number of memories to retrieve, use with latest=true to limit the
            number of memories retrieved
        - name: v
          in: query
          schema:
            type: number
            default: 2
          description: API version - current is 2
        - name: source
          in: query
          schema:
            type: string
          description: Client source identifier (e.g., 'chatgpt' for ChatGPT requests)
        - name: skip
          in: query
          schema:
            type: integer
            default: 0
            minimum: 0
          description: >-
            Number of memories to skip for pagination. Zero-indexed: skip=0
            starts from first memory, skip=10 skips first 10 memories and starts
            from 11th. Used primarily with token limiting to load additional
            memories beyond the initial response.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                oneOf:
                  - type: array
                    items:
                      type: string
                  - type: array
                    items:
                      $ref: '#/components/schemas/Memory'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Memory'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    Memory:
      type: object
      properties:
        text:
          type: string
        score:
          type: number
        metadata:
          type: object
          properties:
            bucketId:
              type: integer
              description: Numeric ID of the bucket
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        text:
          type: string
        score:
          type: number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````