> ## 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.

# List Conversations

> List imported chat conversations with pagination and filtering.

## Overview

List imported chat conversations with pagination and filtering. Use this to browse conversations, filter by platform, or search by title.

### Example

```bash theme={null}
curl "https://www.memoryplugin.com/api/chat-history/chats?page=1&pageSize=10&provider=chatgpt" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml GET /api/chat-history/chats
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/chat-history/chats:
    get:
      summary: List conversations
      description: List imported chat conversations with pagination and filtering.
      operationId: ListConversations
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number (1-indexed).
        - name: pageSize
          in: query
          schema:
            type: integer
            default: 25
            maximum: 100
          description: Results per page.
        - name: provider
          in: query
          schema:
            type: string
            default: all
          description: >-
            Filter by platform. Use 'all' for all platforms, or a specific
            platform ID (e.g., 'chatgpt', 'claude', 'custom').
        - name: title
          in: query
          schema:
            type: string
          description: Filter by conversation title (partial match).
        - name: dateFrom
          in: query
          schema:
            type: string
            format: date
          description: Filter conversations created on or after this date (ISO 8601).
        - name: dateTo
          in: query
          schema:
            type: string
            format: date
          description: Filter conversations created on or before this date (ISO 8601).
        - name: pinnedOnly
          in: query
          schema:
            type: boolean
            default: false
          description: Only return pinned conversations.
        - name: importId
          in: query
          schema:
            type: string
          description: Filter by import ID.
      responses:
        '200':
          description: Paginated conversation list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationListResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ConversationListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                description: Internal conversation ID.
              title:
                type: string
                description: Conversation title.
              platform:
                type: string
                description: Source platform (e.g., 'chatgpt', 'claude', 'custom').
              messageCount:
                type: integer
                description: Number of messages in the conversation.
              tokenCount:
                type: integer
                description: Total tokens in the conversation.
              createdAt:
                type: string
                format: date-time
              updatedAt:
                type: string
                format: date-time
              pinned:
                type: boolean
        page:
          type: integer
          description: Current page number.
        pageSize:
          type: integer
          description: Results per page.
        total:
          type: integer
          description: Total number of conversations matching the filter.
        totalPages:
          type: integer
          description: Total number of pages.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        text:
          type: string
        score:
          type: number
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````