---
title: "Chat History Paginated"
method: GET
path: "/api/chat_history_paginated"
tags: ["Admin"]
---

# Chat History Paginated

`GET /api/chat_history_paginated`

## Request

- Base URL: `https://app.getdot.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.getdot.ai/api/chat_history_paginated`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in cookie `Authorization`
  - OAuth 2 (password, token URL `/api/auth/token`)

Get paginated chat history with server-side filtering and sorting.

This endpoint replaces client-side pagination for better performance.

## Query parameters

- `page` integer: Page number (1-indexed)
- `per_page` integer: Items per page
- `sort_by` string: Sort column
- `sort_order` string: Sort direction
- `filter_type` string: Type filter: all, agentic (Analysis), app (App building: chats that built or edited an app), context_agent (Root), proposals, scheduled (has a schedule), is_scheduled (created by a schedule), shared, training or archived
- `search` string, nullable: Search term
- `labels` string, nullable: Comma-separated label names
- `users` string, nullable: Comma-separated user display names
- `start_date` string, nullable: First day (YYYY-MM-DD) of last activity, included, in `tz`
- `end_date` string, nullable: Last day (YYYY-MM-DD) of last activity, included, in `tz`
- `tz` string, nullable: Viewer's IANA timezone for the date range (default UTC)
- `review` string, nullable: Comma-separated review outcomes; a chat matching any of them is kept

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getdot/apis/dot-api-2.md) · [All operations](https://skmtc.dev/getdot/apis/dot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/getdot/apis/dot-api-2/revisions/d26fe7163a7f?raw)