curl "https://server.smartlead.ai/api/v1/master-inbox/reply-status?api_key=YOUR_KEY&message_id=%3C4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w%40dealversego.co%3E"
import requests
API_KEY = "YOUR_API_KEY"
MESSAGE_ID = "<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>"
response = requests.get(
"https://server.smartlead.ai/api/v1/master-inbox/reply-status",
params={
"api_key": API_KEY,
"message_id": MESSAGE_ID
}
)
result = response.json()
if result["ok"]:
data = result["data"]
print(f"Status: {data['status']}")
print(f"Message: {data['status_message']}")
print(f"Delivered at: {data['event_time']}")
else:
print("Failed to retrieve status")
const API_KEY = 'YOUR_API_KEY';
const MESSAGE_ID = '<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>';
const params = new URLSearchParams({
api_key: API_KEY,
message_id: MESSAGE_ID
});
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/reply-status?${params}`
);
const result = await response.json();
if (result.ok) {
console.log(`Status: ${result.data.status}`);
console.log(`Message: ${result.data.status_message}`);
console.log(`Event time: ${result.data.event_time}`);
}
{
"ok": true,
"data": {
"message_id": "<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>",
"status": "COMPLETED",
"status_message": "Email sent successfully!",
"event_time": "2026-03-12T11:29:05.173Z",
"scheduled_time": null,
"email_stats_id": "4d9ff292-b7a4-45a1-80aa-e1ac2c925404"
}
}
{
"message": "Invalid API Key"
}
{
"ok": false,
"error": "No reply found for the given message_id"
}
Master Inbox
Get Reply Status
Check the delivery status of a sent reply from the unified inbox
GET
/
api
/
v1
/
master-inbox
/
reply-status
curl "https://server.smartlead.ai/api/v1/master-inbox/reply-status?api_key=YOUR_KEY&message_id=%3C4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w%40dealversego.co%3E"
import requests
API_KEY = "YOUR_API_KEY"
MESSAGE_ID = "<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>"
response = requests.get(
"https://server.smartlead.ai/api/v1/master-inbox/reply-status",
params={
"api_key": API_KEY,
"message_id": MESSAGE_ID
}
)
result = response.json()
if result["ok"]:
data = result["data"]
print(f"Status: {data['status']}")
print(f"Message: {data['status_message']}")
print(f"Delivered at: {data['event_time']}")
else:
print("Failed to retrieve status")
const API_KEY = 'YOUR_API_KEY';
const MESSAGE_ID = '<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>';
const params = new URLSearchParams({
api_key: API_KEY,
message_id: MESSAGE_ID
});
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/reply-status?${params}`
);
const result = await response.json();
if (result.ok) {
console.log(`Status: ${result.data.status}`);
console.log(`Message: ${result.data.status_message}`);
console.log(`Event time: ${result.data.event_time}`);
}
{
"ok": true,
"data": {
"message_id": "<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>",
"status": "COMPLETED",
"status_message": "Email sent successfully!",
"event_time": "2026-03-12T11:29:05.173Z",
"scheduled_time": null,
"email_stats_id": "4d9ff292-b7a4-45a1-80aa-e1ac2c925404"
}
}
{
"message": "Invalid API Key"
}
{
"ok": false,
"error": "No reply found for the given message_id"
}
Track whether your reply was successfully delivered. Use this to confirm email delivery status and troubleshoot sending issues.
Overview
Returns the delivery status of a specific reply sent from the master inbox. Use themessage_id from the email headers to look up the current status of the reply.
Use Cases:
- Delivery confirmation: Verify that a reply was successfully sent
- Troubleshooting: Diagnose delivery failures or delays
- Automation workflows: Poll status after sending a reply via API
- Audit trails: Track when replies were actually delivered
Query Parameters
string
required
Your SmartLead API key
string
required
The email Message-ID header value of the reply you want to check.This is the RFC 5322 Message-ID assigned to the email, typically in angle bracket format:
<uuid@domain.com>Example: <4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>curl "https://server.smartlead.ai/api/v1/master-inbox/reply-status?api_key=YOUR_KEY&message_id=%3C4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w%40dealversego.co%3E"
import requests
API_KEY = "YOUR_API_KEY"
MESSAGE_ID = "<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>"
response = requests.get(
"https://server.smartlead.ai/api/v1/master-inbox/reply-status",
params={
"api_key": API_KEY,
"message_id": MESSAGE_ID
}
)
result = response.json()
if result["ok"]:
data = result["data"]
print(f"Status: {data['status']}")
print(f"Message: {data['status_message']}")
print(f"Delivered at: {data['event_time']}")
else:
print("Failed to retrieve status")
const API_KEY = 'YOUR_API_KEY';
const MESSAGE_ID = '<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>';
const params = new URLSearchParams({
api_key: API_KEY,
message_id: MESSAGE_ID
});
const response = await fetch(
`https://server.smartlead.ai/api/v1/master-inbox/reply-status?${params}`
);
const result = await response.json();
if (result.ok) {
console.log(`Status: ${result.data.status}`);
console.log(`Message: ${result.data.status_message}`);
console.log(`Event time: ${result.data.event_time}`);
}
Response Fields
boolean
Whether the request was successful
object
Reply status details
Show data properties
Show data properties
string
The email Message-ID that was queried
string
Delivery status of the reply (e.g.,
COMPLETED when the email was successfully delivered)string
Human-readable description of the current status (e.g.,
"Email sent successfully!")string
ISO 8601 timestamp of when the status event occurred (e.g., when the email was delivered)
string | null
ISO 8601 timestamp of when the email is scheduled to be sent.
null if the email was sent immediately.string
Internal SmartLead identifier for the email statistics record. Can be used to correlate with other analytics data.
Response Codes
Success
Request successful — reply status retrieved
Unauthorized
Invalid or missing API key
Not Found
No reply found for the given message_id
Validation Error
Missing or invalid
message_id parameterInternal Server Error
Server error occurred
{
"ok": true,
"data": {
"message_id": "<4d9ff292-b7a4-45a1-80aa-e1ac2c925404-133jc7w@dealversego.co>",
"status": "COMPLETED",
"status_message": "Email sent successfully!",
"event_time": "2026-03-12T11:29:05.173Z",
"scheduled_time": null,
"email_stats_id": "4d9ff292-b7a4-45a1-80aa-e1ac2c925404"
}
}
{
"message": "Invalid API Key"
}
{
"ok": false,
"error": "No reply found for the given message_id"
}
Related Endpoints
- Reply to Message — Send a reply from the inbox
- Get Inbox Replies — Get all inbox replies
- Get Sent Emails — View all sent emails
