# Get chats for agent

Retrieve chat conversations for an authenticated agent.
Requires agent session authentication.

Endpoint: POST /agent-get-chats
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)

  - `status` (string)
    Enum: "all", "active", "pending", "completed"

## Response 200 fields (application/json):

  - `chats` (array)

  - `chats.id` (string)

  - `chats.user_id` (string)

  - `chats.customer_id` (string)

  - `chats.channel_type` (string)
    Enum: "whatsapp", "instagram", "messenger"

  - `chats.status` (string)
    Enum: "active", "pending", "completed", "archived"

  - `chats.last_message_at` (string)

  - `chats.created_at` (string)

  - `chats.customer` (object)

  - `chats.customer.name` (string)

  - `chats.customer.last_name` (string,null)

  - `chats.customer.phone` (string)

  - `chats.customer.whatsapp_id` (string,null)

  - `chats.customer.email` (string,null)

  - `chats.customer.profile_picture_url` (string,null)

  - `chats.customer.pipeline_stage_id` (string,null)
    Current pipeline stage ID for this contact

  - `chats.customer.pipeline_stage` (object)

  - `chats.customer.pipeline_stage.color` (string)
    Example: "#3B82F6"

  - `chats.customer.pipeline_stage.stage_order` (integer)
    Order/position of this stage in the pipeline

  - `chats.customer.pipeline_stage.is_system` (boolean)
    Whether this is a system-created stage

  - `chats.customer.pipeline_stage.updated_at` (string)

  - `chats.customer.tags` (array)

  - `chats.customer.custom_fields` (array)
    Custom field values for this contact

  - `chats.customer.custom_fields.field_id` (string)

  - `chats.customer.custom_fields.field_value` (string,null)

  - `chats.customer.custom_fields.field` (object)

  - `chats.customer.custom_fields.field.field_name` (string)
    Example: "Company"

  - `chats.customer.custom_fields.field.field_type` (string)
    Enum: "text", "email", "phone", "number", "date", "select"

  - `chats.customer.custom_fields.field.field_options` (array,null)
    Options for select type fields

  - `chats.customer.custom_fields.field.is_required` (boolean)

  - `chats.customer.custom_fields.field.field_order` (integer)

  - `chats.messages` (array)

  - `chats.messages.chat_id` (string)

  - `chats.messages.content` (string)

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

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

  - `chats.messages.is_read` (boolean)

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

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

  - `chats.messages.metadata` (object)

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

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

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

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

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

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

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

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

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message