{"id":3566,"date":"2023-08-29T19:18:57","date_gmt":"2023-08-29T18:18:57","guid":{"rendered":"https:\/\/help.expertsender.com\/?post_type=es&p=3566"},"modified":"2025-10-15T09:06:25","modified_gmt":"2025-10-15T08:06:25","slug":"get-messages-list","status":"publish","type":"es","link":"https:\/\/help.expertsender.com\/pl\/emp\/api\/methods\/email-messages\/get-messages-list\/","title":{"rendered":"Get messages list"},"content":{"rendered":"\n

Messages collection contains a list of all sent messages. Multiple messages matching specified criteria can be retrieved. Specifying single message ID can be used to retrieve detailed information about a specific message.<\/p>\n\n\n\n

<\/a><\/a>Request data format<\/strong><\/h3>\n\n\n\n

Get multiple messages<\/strong><\/p>\n\n\n\n

Request URL parameters:<\/p>\n\n\n\n

Element\/attribute<\/th>Type<\/th>Notes<\/th><\/tr><\/thead>
apiKey<\/td>string<\/td>Your API key, required for authentication. Required.<\/td><\/tr>
tag<\/td>string<\/td>Tag. Optional. If specified, only messages tagged with its value will be returned.<\/td><\/tr>
startDate<\/td>date<\/td>Start date. Optional. If specified, messages sent before this date will not be returned. May be used together with endDate to specify a period of time. YYYY-MM-DD format.<\/td><\/tr>
endDate<\/td>date<\/td>See startDate.<\/td><\/tr>
type<\/td>string<\/td>Only return specific message types. Optional. Valid values:
Newsletter
Autoresponder
Trigger
Transactional
Confirmation
Recurring
Test
FreeEmailPreview
PaidEmailPreview
WorkflowMessage<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Examples:<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
https:\/\/api.esv2.com\/v2\/Api\/Messages?apiKey=YOUR_API_KEY_HERE <\/span><\/span>\nhttps:\/\/api.esv2.com\/v2\/Api\/Messages?apiKey=YOUR_API_KEY_HERE&tag=sports <\/span><\/span>\nhttps:\/\/api.esv2.com\/v2\/Api\/Messages?apiKey=YOUR_API_KEY_HERE&tag=sports&startDate=2010-05-20&endDate=2010-05-22<\/span><\/span>\nhttps:\/\/api.esv2.com\/v2\/Api\/Messages?apiKey=YOUR_API_KEY_HERE&tag=sports&startDate=2010-05-20&endDate=2010-05-22&type=Recurring<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Get message by Message ID<\/strong><\/p>\n\n\n\n
Request URL parameters:<\/p>\n\n\n\n
Element\/attribute<\/th>Type<\/th>Notes<\/th><\/tr><\/thead>
apiKey<\/td>string<\/td>Your API key, required for authentication. Required.<\/td><\/tr>
ID<\/td>int<\/td>Message ID. Required as a part of address (not GET parameter). See example below.<\/td><\/tr>
fullDetails<\/td>boolean<\/td>If set to \u201ctrue\u201d, full message details will be returned. By default set to \u201cfalse\u201d. Optional.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Examples:<\/p>\n\n\n\n