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
}

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.