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

# List Chats

> Retrieve a paginated list of chats for the authenticated user

Returns a list of chat title and ID summaries for the current user, with optional pagination and filtering.

## Query Parameters

<ParamField query="page" type="integer" optional>
  Page number for pagination. When provided, returns 60 chats per page.
</ParamField>

<ParamField query="include_pinned" type="boolean" default={false}>
  Include pinned chats in the results.
</ParamField>

<ParamField query="include_folders" type="boolean" default={false}>
  Include chats that are in folders.
</ParamField>

## Response

<ResponseField name="Response" type="array">
  Array of chat summary objects

  <Expandable title="Chat Summary Object">
    <ResponseField name="id" type="string" required>
      Unique identifier for the chat
    </ResponseField>

    <ResponseField name="title" type="string" required>
      Chat title
    </ResponseField>

    <ResponseField name="updated_at" type="integer" required>
      Unix timestamp (epoch seconds) when chat was last updated
    </ResponseField>

    <ResponseField name="created_at" type="integer" required>
      Unix timestamp (epoch seconds) when chat was created
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://your-domain.com/api/chats?page=1&include_pinned=true" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "AI Assistant Conversation",
      "updated_at": 1709251200,
      "created_at": 1709164800
    },
    {
      "id": "660f9511-f3ac-52e5-b827-557766551111",
      "title": "Code Review Discussion",
      "updated_at": 1709164800,
      "created_at": 1709078400
    }
  ]
  ```
</ResponseExample>