List Email
List Emails with filters in Dhesend API.
import Dhesend from 'dhesend';
const dhesend = new Dhesend('dhe_fdd03c4eb1');
dhesend.email.list();{
"next": false, // has more emails or not
"emails": [
// just like get email response
{
"id": "759cd214-98db-40c1-9df4-66d818a51c3a",
"createdAt": "2024-12-31T11:17:26.332Z",
"to": "dhesend@gmail.com",
"subject": "Hello, it is working!",
"status": "scheduled",
...
},
...
]
}Endpoint
Use this endpoint to list emails using GET request.
GET /email/list
Use the query parameters below to filter results.
GET /email/list?search=hello&time=3&status=failed&page=2
Query parameters
pagenumber
The page number for pagination.
E.g./email/list?page=2
timenumber
Filter emails by the past number of days.
E.g./email/list?time=7
statusstring
The status of the emails.
Possible values:alldeliveryscheduledsentcomplaintbouncefailedopenedclicked
E.g./email/list?status=sent
searchstring
A search term to filter emails. The search term can match:
E.g.
- The email recipient(s).
- The email subject (case-insensitive).
E.g.
/email/list?search=ali@example.comor/email/list?search=Meeting