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

# Chat history

> List your Vouch AI conversations.

Returns the authenticated user's chats, most recently updated first, with pagination.

<Note>
  Vouch AI endpoints require a positive wallet balance, including reads like this one.
</Note>

## Query parameters

<ParamField query="page" type="integer" default="1" />

<ParamField query="limit" type="integer" default="10" />

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.vouchmark.com/v1/chat/history?page=1&limit=10" \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "chats": [
      {
        "_id": "chat_aBcD...",
        "title": "TEKCIFY TECHNOLOGIES LTD - 6/27/2026",
        "companyId": "cmp_aBcD...",
        "updatedAt": "2026-06-27T10:05:02Z",
        "createdAt": "2026-06-27T10:00:00Z",
        "messageCount": 6,
        "companyName": "TEKCIFY TECHNOLOGIES LTD",
        "rcNumber": "RC1234567"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 1,
      "totalItems": 1,
      "itemsPerPage": 10,
      "hasNextPage": false,
      "hasPrevPage": false
    }
  }
  ```
</ResponseExample>

Each chat is identified by `_id`. `companyName` and `rcNumber` are joined from the chat's company and may be `null` if the company no longer exists.