curl -X POST "https://server.smartlead.ai/api/v1/master-inbox/sent?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "offset": 0,
    "limit": 20,
    "filters": {
      "emailStatus": ["Replied", "Opened"],
      "campaignId": [12345, 12346],
      "leadCategories": {
        "categoryIdsIn": [1]
      },
      "replyTimeBetween": ["2025-01-01T00:00:00Z", "2025-01-31T23:59:59Z"]
    },
    "sortBy": "REPLY_TIME_DESC"
  }'

import requests
from datetime import datetime, timedelta

API_KEY = "YOUR_API_KEY"

# Example 1: Get replied emails from last 7 days
seven_days_ago = (datetime.now() - timedelta(days=7)).isoformat() + 'Z'
now = datetime.now().isoformat() + 'Z'

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

response = requests.post(
    "https://server.smartlead.ai/api/v1/master-inbox/sent",
    params={"api_key": API_KEY},
    json=payload
)

result = response.json()
print(f"Found {result.get('total_count', 0)} interested replies in last 7 days")
for msg in result.get('messages', []):
    print(f"- {msg['lead']['email']}: {msg['email_status']}")

const API_KEY = 'YOUR_API_KEY';

// Example 2: Get opened but not replied emails from specific campaign
const payload = {
  offset: 0,
  limit: 20,
  filters: {
    emailStatus: ['Opened', 'Clicked'],  // Engaged but not replied
    campaignId: 12345,
    leadCategories: {
      unassigned: true  // Not yet categorized
    }
  },
  sortBy: 'SENT_TIME_DESC'
};

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

const result = await response.json();
console.log(`${result.total_count} engaged leads need follow-up`);

# Example 3: Multi-campaign performance comparison
payload = {
    "filters": {
        "campaignId": [12345, 12346, 12347],  # Multiple campaigns
        "emailStatus": ["Replied", "Opened", "Clicked"],
        "campaignTeamMemberId": 456,  # Specific team member
        "campaignTagId": 5  # VIP tag
    },
    "limit": 20
}

response = requests.post(
    "https://server.smartlead.ai/api/v1/master-inbox/sent",
    params={"api_key": API_KEY},
    json=payload
)

# Group by campaign for comparison
results_by_campaign = {}
for msg in response.json().get('messages', []):
    campaign_id = msg['campaign']['id']
    if campaign_id not in results_by_campaign:
        results_by_campaign[campaign_id] = []
    results_by_campaign[campaign_id].append(msg)

for campaign_id, messages in results_by_campaign.items():
    print(f"Campaign {campaign_id}: {len(messages)} engaged leads")

{
  "messages": [
    {
      "id": "msg_abc123",
      "campaign_lead_map_id": "2433664091",
      "lead": {
        "email": "john@company.com",
        "first_name": "John",
        "last_name": "Doe",
        "company": "ACME Corp"
      },
      "campaign": {
        "id": 12345,
        "name": "Q1 2025 Outreach"
      },
      "email_account": {
        "id": 789,
        "email": "sales@yourcompany.com"
      },
      "last_message": {
        "subject": "Partnership Opportunity",
        "sent_at": "2025-01-15T10:00:00Z",
        "opened_at": "2025-01-15T10:30:00Z",
        "replied_at": "2025-01-15T14:00:00Z"
      },
      "email_status": "Replied",
      "category": {
        "id": 1,
        "name": "Interested"
      },
      "assigned_to": {
        "id": 456,
        "name": "Jane Smith"
      },
      "stats": {
        "opens": 2,
        "clicks": 1,
        "replies": 1
      }
    }
  ],
  "total_count": 1,
  "offset": 0,
  "limit": 20
}

{
  "message": "Invalid API Key"
}

{
  "error": "limit must be between 1 and 20",
  "field": "limit",
  "provided_value": 50
}