List Emails
Retrieve and filter your sent emails.
Endpoint
GET https://getmailer.co/api/emailsQuery Parameters
| Parameter | Type | Description |
|---|---|---|
limit | number | Max results to return (default: 20, max: 100) |
offset | number | Number of results to skip (for pagination) |
status | string | Filter by status (sent, delivered, bounced, etc.) |
tag | string | Filter by tag |
from | string | Filter by sender email |
to | string | Filter by recipient email |
since | string | ISO 8601 datetime - only emails after this time |
Response
{
"emails": [
{
"id": "clx1abc123def456",
"from": "[email protected]",
"to": ["[email protected]"],
"subject": "Welcome!",
"status": "delivered",
"tags": ["welcome"],
"createdAt": "2024-01-15T10:30:00Z",
"deliveredAt": "2024-01-15T10:30:02Z"
}
],
"total": 150,
"limit": 20,
"offset": 0
}Email Status Values
| Status | Description |
|---|---|
queued | Email is queued for sending |
sent | Email sent to the recipient's mail server |
delivered | Email accepted by recipient's mail server |
bounced | Email bounced (invalid address, full mailbox, etc.) |
complained | Recipient marked email as spam |
scheduled | Email is scheduled for future delivery |
cURL Example
curl "https://getmailer.co/api/emails?limit=10&status=delivered&tag=welcome" \ -H "Authorization: Bearer gm_your_api_key"
Get Single Email
Retrieve a specific email by its ID:
GET https://getmailer.co/api/emails/:idcurl "https://getmailer.co/api/emails/clx1abc123def456" \ -H "Authorization: Bearer gm_your_api_key"