# Get messages for a chat (agent)

Retrieve messages for a specific chat conversation.
Requires agent session authentication.

Endpoint: POST /agent-get-messages
Version: 1.1.0
Security: BearerAuth

## Request fields (application/json):

  - `agentSession` (object, required)

  - `agentSession.agent` (object, required)

  - `agentSession.agent.id` (string)

  - `agentSession.agent.name` (string)

  - `agentSession.agent.email` (string)

  - `agentSession.agent.role` (string)

  - `agentSession.agent.owner_user_id` (string)

  - `agentSession.agent.organization_id` (string,null)

  - `agentSession.permissions` (object)

  - `agentSession.session` (object, required)

  - `agentSession.session.token` (string)

  - `agentSession.session.expires_at` (string)

  - `chatId` (string, required)

  - `limit` (integer)

## Response 200 fields (application/json):

  - `messages` (array)

  - `messages.id` (string)

  - `messages.chat_id` (string)

  - `messages.content` (string)

  - `messages.sender_type` (string)
    Enum: "customer", "business", "agent", "system"

  - `messages.message_type` (string)
    Enum: "text", "image", "video", "audio", "document", "location"

  - `messages.created_at` (string)

  - `messages.is_read` (boolean)

  - `messages.status` (string,null)
    Message delivery status (for business/agent sent messages)
    Enum: "sent", "delivered", "read"

  - `messages.whatsapp_message_id` (string,null)
    WhatsApp message ID (wamid.xxx format for Meta API)

  - `messages.metadata` (object)

  - `messages.metadata.quotedMessage` (object)
    Quoted message information

  - `messages.metadata.quotedMessage.type` (string)
    Enum: "text", "image", "video", "audio", "document"

  - `messages.metadata.quotedMessage.caption` (string,null)

  - `messages.metadata.quotedMessage.url` (string,null)

  - `messages.metadata.imageUrl` (string,null)

  - `messages.metadata.videoUrl` (string,null)

  - `messages.metadata.audioUrl` (string,null)

  - `messages.metadata.documentUrl` (string,null)

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message

## Response 403 fields (application/json):

  - `error` (string, required)
    Error message

## Response 404 fields (application/json):

  - `error` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message