Skip to main content
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"

{
    "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"
    }
}

Documentation Index

Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 the message_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

​
api_key
string
required
Your SmartLead API key
​
message_id
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"

​
Response Fields

​
ok
boolean
Whether the request was successful
​
data
object
Reply status details

​
Response Codes

​
200
Success
Request successful — reply status retrieved
​
401
Unauthorized
Invalid or missing API key
​
404
Not Found
No reply found for the given message_id
​
422
Validation Error
Missing or invalid message_id parameter
​
500
Internal 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"
    }
}