Skip to main content
GET
/
api
/
chat-history
/
chats
List conversations
curl --request GET \
  --url https://www.memoryplugin.com/api/chat-history/chats \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "<string>",
      "title": "<string>",
      "platform": "<string>",
      "messageCount": 123,
      "tokenCount": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "pinned": true
    }
  ],
  "page": 123,
  "pageSize": 123,
  "total": 123,
  "totalPages": 123
}

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.

Overview

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

Example

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

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number (1-indexed).

pageSize
integer
default:25

Results per page.

Required range: x <= 100
provider
string
default:all

Filter by platform. Use 'all' for all platforms, or a specific platform ID (e.g., 'chatgpt', 'claude', 'custom').

title
string

Filter by conversation title (partial match).

dateFrom
string<date>

Filter conversations created on or after this date (ISO 8601).

dateTo
string<date>

Filter conversations created on or before this date (ISO 8601).

pinnedOnly
boolean
default:false

Only return pinned conversations.

importId
string

Filter by import ID.

Response

Paginated conversation list

items
object[]
page
integer

Current page number.

pageSize
integer

Results per page.

total
integer

Total number of conversations matching the filter.

totalPages
integer

Total number of pages.