---
title: How do I read and understand execution reports?
description: "Every time a recurring SMS campaign executes, a detailed report is generated. **Accessing Reports:** **Method 1: From Campaign List** 1. Go to **Compose SMS → Recurring SMS** 2. Find your campaign 3. Click the **\"Reports\"** button **Method 2: Direct Link**…"
url: "https://www.smsgatewaycenter.com/blog/kb/how-do-i-read-and-understand-execution-reports/"
updated: "2025-10-23"
category: Bulk SMS / Recurring SMS
---

# How do I read and understand execution reports?

Every time a recurring SMS campaign executes, a detailed report is generated.

**Accessing Reports:**

**Method 1: From Campaign List**

1. Go to **Compose SMS → Recurring SMS**
2. Find your campaign
3. Click the **"Reports"** button

**Method 2: Direct Link**

- Reports tab shows overview
- Click on specific execution for details

**Report Metrics Explained:**

### **Execution Status**

**🟢 SUCCESS** - All messages sent successfully
**🔴 FAILED** - All messages failed to send
**🟡 PARTIAL** - Some succeeded, some failed

### **Key Metrics**

| Metric | What It Means |
| --- | --- |
| **Execution Time** | Date and time when campaign ran |
| **Total Recipients** | Total unique contacts |
| **Success Count** | Messages delivered successfully |
| **Failed Count** | Messages that failed |
| **Credits Used** | SMS credits consumed |
| **Transaction ID** | Unique ID for tracking |

### **Statistics Dashboard**

At the top of reports page:

- **Total Executions:** How many times campaign has run
- **Successful Executions:** How many times all messages succeeded
- **Failed Executions:** How many times execution failed
- **Success Rate:** Percentage of successful executions

**Understanding API Response:**

Each report includes the raw API response for troubleshooting:

```
{
  "status": "success",
  "transactionId": "TXN123456",
  "totalRecipients": 150,
  "message": "Messages sent successfully"
}
```

**Common Failure Reasons:**

| Error Message | Cause | Solution |
| --- | --- | --- |
| "Insufficient credits" | Low balance | Add credits to account |
| "Invalid sender ID" | Sender ID not active | Activate sender ID |
| "No contacts found" | Empty group | Add contacts to group |
| "DLT template invalid" | Template issue | Verify DLT template |

**Export Reports:**

- Click **"Export"** button
- Downloads CSV with all executions
- Includes all metrics and error details
- Useful for analysis in Excel

**Best Practices:**

1. **Check reports weekly** - Identify issues early
2. **Monitor success rates** - Rates below 95% need attention
3. **Review failures** - Fix root causes
4. **Track credits** - Plan budget based on usage patterns
5. **Save transaction IDs** - Use for support queries

### More Related Articles

- [What are the best practices for running successful recurring campaigns?](https://www.smsgatewaycenter.com/blog/kb/what-are-the-best-practices-for-running-successful-recurring-campaigns/)
- [How secure is Recurring SMS? Who can access my campaigns?](https://www.smsgatewaycenter.com/blog/kb/how-secure-is-recurring-sms-who-can-access-my-campaigns/)
- [How do I permanently delete a recurring campaign?](https://www.smsgatewaycenter.com/blog/kb/how-do-i-permanently-delete-a-recurring-campaign/)

Found this useful?[Add as Preferred Source on Google](https://www.google.com/preferences/source?q=smsgatewaycenter.com)