Email
Get email
Getting Started
- Welcome to Self Mail Kit
- How to Deploy
API Reference
Endpoints
- Email
- Domain
- Audience
- Contact
Email
Get email
Endpoint: v1/emails/{id}
Retrieve the status and details of a specific email
curl --request GET \
--url https://api.{your-domain.com}/v1/emails/{id} \
--header 'Authorization: Bearer <token>'
{
"id": "0195c9e3-5067-741d-be87-a4f75ef93372",
"type": "transactional",
"to": [
"recipient@company.com"
],
"subject": "Your Order Confirmation #12345",
"template_id": null,
"domain_id": "0195b357-d03d-754e-8ccd-8254807df021",
"html": "<!DOCTYPE html><html><body><h1>Order Confirmation</h1>...</body></html>",
"text": "Order Confirmation\\n\\nThank you for your order #12345...",
"from": "Support Team <support@company.com>",
"email_sent_timestamp": 1709225600000,
"last_event": {
"link": "https://company.com/order/12345",
"recipient": "recipient@company.com",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
"status": "clicked",
"timestamp": 1709225720000,
"ip": "192.0.2.1"
},
"recipient_statuses": [
{
"recipient": "recipient@company.com",
"events": [
{
"status": "sent",
"timestamp": 1742139519852
},
{
"status": "delivered",
"timestamp": 1742139520744
},
{
"status": "opened",
"timestamp": 1742139523114,
"ip": "192.0.2.2",
"user_agent": "Amazon CloudFront"
},
{
"status": "clicked",
"timestamp": 1742139613070,
"ip": "192.0.2.1",
"user_agent": "Amazon CloudFront"
}
]
}
]
}
Authorizations
API key with format "Bearer {your-api-key}"
Path Parameters
Unique identifier of the email
Response
200
application/json
OK
The response is of type any
.
curl --request GET \
--url https://api.{your-domain.com}/v1/emails/{id} \
--header 'Authorization: Bearer <token>'
{
"id": "0195c9e3-5067-741d-be87-a4f75ef93372",
"type": "transactional",
"to": [
"recipient@company.com"
],
"subject": "Your Order Confirmation #12345",
"template_id": null,
"domain_id": "0195b357-d03d-754e-8ccd-8254807df021",
"html": "<!DOCTYPE html><html><body><h1>Order Confirmation</h1>...</body></html>",
"text": "Order Confirmation\\n\\nThank you for your order #12345...",
"from": "Support Team <support@company.com>",
"email_sent_timestamp": 1709225600000,
"last_event": {
"link": "https://company.com/order/12345",
"recipient": "recipient@company.com",
"user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
"status": "clicked",
"timestamp": 1709225720000,
"ip": "192.0.2.1"
},
"recipient_statuses": [
{
"recipient": "recipient@company.com",
"events": [
{
"status": "sent",
"timestamp": 1742139519852
},
{
"status": "delivered",
"timestamp": 1742139520744
},
{
"status": "opened",
"timestamp": 1742139523114,
"ip": "192.0.2.2",
"user_agent": "Amazon CloudFront"
},
{
"status": "clicked",
"timestamp": 1742139613070,
"ip": "192.0.2.1",
"user_agent": "Amazon CloudFront"
}
]
}
]
}