> ## Documentation Index > Fetch the complete documentation index at: https://docs.boostgpt.co/llms.txt > Use this file to discover all available pages before exploring further. # Get Chat History > Fetch messages from a specific chat conversation ## OpenAPI ````yaml /api-reference/openapi.json get /v1/bot/chat/read openapi: 3.0.0 info: title: BoostGPT API version: 1.0.0 description: API for managing AI agents with memory capabilities servers: - url: https://api.boostgpt.co description: Production server security: - BearerAuth: [] tags: - name: Agent description: Operations for managing AI agents - name: Memory description: Operations for managing agent memory sources - name: Chat description: Operations for chatting with agents and managing conversations - name: Subscribers description: Operations for managing subscribers and leads - name: Tools description: Operations for managing agent tools and MCP server integrations - name: Analytics description: Operations for retrieving agent statistics and analytics - name: Heartbeat description: Operations for managing autonomous agent scheduling and execution - name: User Memory description: Operations for managing per-user memory entries - name: Email description: Operations for managing agent email functionality - name: Triggers description: Operations for firing proactive agent trigger events - name: CRM description: >- Operations for managing agent CRM contacts, pipelines, deals, follow-ups, and reports - name: Workflows description: Operations for managing agent workflow automations - name: Calendar description: Operations for managing agent calendar settings, availability, and events - name: Workspace description: Operations for managing agent workspaces and files paths: /v1/bot/chat/read: get: tags: - Chat summary: Get Chat History description: Fetch messages from a specific chat conversation parameters: - name: project_id in: query required: true schema: type: string description: Project ID - name: bot_id in: query required: true schema: type: string description: Agent ID - name: chat_id in: query required: true schema: type: string description: Chat ID - name: page in: query required: false schema: type: integer default: 1 description: Page number - name: per_page in: query required: false schema: type: integer default: 10 description: Items per page responses: '200': description: Chat history retrieved successfully content: application/json: schema: $ref: '#/components/schemas/ChatHistoryResponse' components: schemas: ChatHistoryResponse: type: object properties: total: type: integer description: Total number of messages conversation: type: array items: type: object properties: uuid: type: string description: Message unique identifier chat_id: type: string description: Chat conversation ID content: type: string description: Message content role: type: string enum: - user - system description: Message role model: type: string description: AI model used for this message complexity: type: string description: Message complexity level reasoning_type: type: string description: Type of reasoning used (e.g., standard, agent) estimated_time_ms: type: string description: Estimated processing time in milliseconds estimated_cost: type: string description: Estimated cost confidence: type: string description: Confidence level channel: type: string description: Communication channel (e.g., web, api) credit_used: type: string description: Credits consumed confidence_score: type: string description: Confidence score percentage tokens: type: integer description: Number of tokens used upvotes: type: integer description: Number of upvotes downvotes: type: integer description: Number of downvotes reasoning: type: object description: Detailed reasoning information nullable: true preference: type: object description: User preferences for this message nullable: true properties: model: type: string description: Preferred model maxTokens: type: integer description: Maximum tokens complexity: type: string description: Complexity preference reasoningType: type: string description: Reasoning type preference sources: type: array description: Sources referenced in the response nullable: true items: type: object properties: url: type: string description: Source URL tags: type: array items: type: string description: Source tags type: type: string description: Source type (e.g., website) title: type: string description: Source title favicon: type: string description: Source favicon URL source_id: type: string description: Source identifier citation_number: type: integer description: Citation number updated_at: type: string format: date-time description: Last update timestamp user: type: object description: User information nullable: true properties: uuid: type: string description: User unique identifier email: type: string description: User email name: type: string description: User name avatar: type: string description: User avatar filename nullable: true avatar_link: type: string description: User avatar URL isToolExecuting: type: boolean description: Whether a tool is currently executing pagination: $ref: '#/components/schemas/Pagination' Pagination: type: object properties: page: type: integer description: Current page number per_page: type: integer description: Items per page total: type: integer description: Total number of items total_pages: type: integer description: Total number of pages securitySchemes: BearerAuth: type: http scheme: bearer description: Enter your API key ````