curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/inbox-replies?api_key=YOUR_KEY&fetch_message_history=false" \
  -H "Content-Type: application/json" \
  -d '{
    "offset": 0,
    "limit": 20,
    "filters": {
      "emailStatus": "Replied",
      "campaignId": [12345, 12346],
      "leadCategories": {
        "categoryIdsIn": [1]
      }
    },
    "sortBy": "REPLY_TIME_DESC"
  }'

import requests
from datetime import datetime, timedelta

API_KEY = "YOUR_API_KEY"

# Example 1: Get today's replies from interested leads
today_start = datetime.now().replace(hour=0, minute=0, second=0).isoformat() + 'Z'
now = datetime.now().isoformat() + 'Z'

payload = {
    "offset": 0,
    "limit": 20,
    "filters": {
        "emailStatus": "Replied",
        "leadCategories": {
            "categoryIdsIn": [1]  # Interested category
        },
        "replyTimeBetween": [today_start, now]
    },
    "sortBy": "REPLY_TIME_DESC"
}

response = requests.post(
    "https://server.smartlead.ai/api/v1/master-inbox/inbox-replies",
    params={
        "api_key": API_KEY,
        "fetch_message_history": False  # Fast list view
    },
    json=payload
)

result = response.json()
print(f"Today's interested replies: {result.get('total_count', 0)}")

# Process each reply
for message in result.get('messages', []):
    lead = message['lead']
    last_msg = message['last_message']
    print(f"\n{lead['email']}: {last_msg['subject']}")
    print(f"Replied at: {last_msg['received_at']}")

const API_KEY = 'YOUR_API_KEY';

// Example 2: Get unread replies with full message history
async function getUnreadReplies() {
  const payload = {
    offset: 0,
    limit: 20,
    filters: {
      emailStatus: 'Replied',
      // Add more filters as needed
    },
    sortBy: 'REPLY_TIME_DESC'
  };

  const response = await fetch(
    `https://server.smartlead.ai/api/v1/master-inbox/inbox-replies?api_key=${API_KEY}&fetch_message_history=true`,
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(payload)
    }
  );

  const result = await response.json();
  
  // Process replies with full conversation context
  for (const message of result.messages || []) {
    console.log(`\n${message.lead.email}`);
    
    if (message.message_history) {
      console.log(`  Thread length: ${message.message_history.length} messages`);
      // Display full conversation
      message.message_history.forEach((msg, idx) => {
        console.log(`  ${idx + 1}. [${msg.direction}] ${msg.subject}`);
      });
    }
  }
  
  return result;
}

getUnreadReplies();

# Example 3: Compare reply rates across campaigns
campaigns_to_compare = [12345, 12346, 12347]

results_by_campaign = {}

for campaign_id in campaigns_to_compare:
    payload = {
        "filters": {
            "campaignId": campaign_id,
            "emailStatus": "Replied"
        },
        "limit": 20
    }
    
    response = requests.post(
        "https://server.smartlead.ai/api/v1/master-inbox/inbox-replies",
        params={"api_key": API_KEY, "fetch_message_history": False},
        json=payload
    )
    
    data = response.json()
    results_by_campaign[campaign_id] = {
        'total_replies': data.get('total_count', 0),
        'messages': data.get('messages', [])
    }

# Analyze results
for campaign_id, data in results_by_campaign.items():
    print(f"Campaign {campaign_id}: {data['total_replies']} replies")

{
  "messages": [
    {
      "id": "msg_xyz789",
      "campaign_lead_map_id": "2433664091",
      "lead": {
        "email": "sarah@startup.io",
        "first_name": "Sarah",
        "last_name": "Johnson",
        "company": "Startup Inc",
        "phone": "+1-555-0100"
      },
      "campaign": {
        "id": 12345,
        "name": "Q1 2025 SaaS Outreach"
      },
      "email_account": {
        "id": 789,
        "email": "sales@yourcompany.com",
        "name": "Sales Team"
      },
      "last_message": {
        "id": "email_abc123",
        "subject": "Re: Partnership Opportunity",
        "body": "Thanks for reaching out! I'm interested in learning more about your solution...",
        "received_at": "2025-01-20T14:30:00Z",
        "sent_from": "sarah@startup.io",
        "sent_to": "sales@yourcompany.com"
      },
      "email_status": "Replied",
      "category": {
        "id": 1,
        "name": "Interested"
      },
      "assigned_to": {
        "id": 456,
        "name": "Jane Smith",
        "email": "jane@yourcompany.com"
      },
      "stats": {
        "total_sent": 3,
        "total_opened": 2,
        "total_clicked": 1,
        "total_replied": 1,
        "last_activity": "2025-01-20T14:30:00Z"
      },
      "is_read": false,
      "is_important": false,
      "is_archived": false,
      "tags": ["hot-lead", "enterprise"]
    }
  ],
  "total_count": 1,
  "offset": 0,
  "limit": 20
}

{
  "messages": [
    {
      "id": "msg_xyz789",
      "campaign_lead_map_id": "2433664091",
      "lead": {...},
      "last_message": {...},
      "message_history": [
        {
          "id": "msg_1",
          "subject": "Partnership Opportunity",
          "body": "Hi Sarah, I noticed your company...",
          "direction": "outbound",
          "sent_at": "2025-01-15T10:00:00Z",
          "opened_at": "2025-01-15T10:30:00Z"
        },
        {
          "id": "msg_2",
          "subject": "Re: Partnership Opportunity",
          "body": "Thanks for reaching out! I'm interested...",
          "direction": "inbound",
          "received_at": "2025-01-20T14:30:00Z"
        }
      ],
      "email_status": "Replied",
      "...": "..."
    }
  ],
  "total_count": 1
}

{
  "message": "Invalid API Key"
}

{
  "error": "campaignId array cannot exceed 5 items",
  "field": "filters.campaignId",
  "provided_count": 10,
  "max_allowed": 5
}