mailtrap · mklocek · Mar 31, 2026 · Mar 17, 2026 · Mar 17, 2026
diff --git a/README.md b/README.md
@@ -240,6 +240,8 @@ Email API:
 - Batch send with Template (Transactional) – [`batch/transactional_template.php`](examples/batch/transactional_template.php)
 - Batch send with Template (Bulk) – [`batch/bulk_template.php`](examples/batch/bulk_template.php)
 - Sending domain management CRUD – [`sending-domains/all.php`](examples/sending-domains/all.php)
+- Suppressions (find & delete) – [`sending/suppressions.php`](examples/sending/suppressions.php)
+- Email Logs (list & get by message ID) – [`sending/email-logs.php`](examples/sending/email-logs.php)
 
 Email Sandbox (Testing):
 - Send an email (Sandbox) – [`testing/send-mail.php`](examples/testing/send-mail.php)
@@ -260,7 +262,6 @@ Contact management:
 
 General API:
 - Templates CRUD – [`templates/all.php`](examples/templates/all.php)
-- Suppressions (find & delete) – [`sending/suppressions.php`](examples/sending/suppressions.php)
 - Billing info – [`general/billing.php`](examples/general/billing.php)
 - Accounts info – [`general/accounts.php`](examples/general/accounts.php)
 - Permissions listing – [`general/permissions.php`](examples/general/permissions.php)

diff --git a/examples/batch/bulk.php b/examples/batch/bulk.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Email Batch Sending API (Bulk)

diff --git a/examples/batch/bulk_template.php b/examples/batch/bulk_template.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Email Batch Sending WITH TEMPLATE (Bulk)

diff --git a/examples/batch/sandbox.php b/examples/batch/sandbox.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Test Email Batch

diff --git a/examples/batch/sandbox_template.php b/examples/batch/sandbox_template.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Test Email Batch WITH TEMPLATE

diff --git a/examples/batch/transactional.php b/examples/batch/transactional.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Email Batch Sending API (Transactional)

diff --git a/examples/batch/transactional_template.php b/examples/batch/transactional_template.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Email Batch Sending WITH TEMPLATE (Transactional)

diff --git a/examples/bulk/bulk.php b/examples/bulk/bulk.php
@@ -7,7 +7,7 @@
 use Symfony\Component\Mime\Email;
 use Symfony\Component\Mime\Header\UnstructuredHeader;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Email Bulk Sending API

diff --git a/examples/bulk/bulk_template.php b/examples/bulk/bulk_template.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 /**
  * Email Bulk Sending WITH TEMPLATE

diff --git a/examples/config/all.php b/examples/config/all.php
@@ -8,7 +8,7 @@
 use Symfony\Component\HttpClient\Psr18Client;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 
 $apiToken = $_ENV['MAILTRAP_API_KEY'];

diff --git a/examples/contact-fields/all.php b/examples/contact-fields/all.php
@@ -9,7 +9,7 @@
 use Mailtrap\MailtrapGeneralClient;
 use Mailtrap\DTO\Request\Contact\ContactExportFilter;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/contact-lists/all.php b/examples/contact-lists/all.php
@@ -9,7 +9,7 @@
 use Mailtrap\MailtrapGeneralClient;
 use Mailtrap\DTO\Request\Contact\ContactExportFilter;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/contacts/all.php b/examples/contacts/all.php
@@ -9,7 +9,7 @@
 use Mailtrap\MailtrapGeneralClient;
 use Mailtrap\DTO\Request\Contact\ContactExportFilter;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/general/accounts.php b/examples/general/accounts.php
@@ -4,7 +4,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapGeneralClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens
 $generalAccounts = (new MailtrapGeneralClient($config))->accounts();

diff --git a/examples/general/billing.php b/examples/general/billing.php
@@ -4,7 +4,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapGeneralClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = (int) $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/general/permissions.php b/examples/general/permissions.php
@@ -8,7 +8,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapGeneralClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/general/users.php b/examples/general/users.php
@@ -4,7 +4,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapGeneralClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/sending/all.php b/examples/sending/all.php
@@ -7,7 +7,7 @@
 use Symfony\Component\Mime\Email;
 use Symfony\Component\Mime\Header\UnstructuredHeader;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 
 /**

diff --git a/examples/sending/email-logs.php b/examples/sending/email-logs.php
@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+use Mailtrap\Config;
+use Mailtrap\DTO\Request\EmailLogs\EmailLogsListFilters;
+use Mailtrap\DTO\Request\EmailLogs\FilterCriterion;
+use Mailtrap\DTO\Request\EmailLogs\EmailLogsFilterOperator;
+use Mailtrap\Helper\ResponseHelper;
+use Mailtrap\MailtrapSendingClient;
+
+require __DIR__ . '/../../vendor/autoload.php';
+
+$accountId = (int) $_ENV['MAILTRAP_ACCOUNT_ID'];
+$config = new Config($_ENV['MAILTRAP_API_KEY']);
+$emailLogs = (new MailtrapSendingClient($config))->emailLogs($accountId);
+
+/**
+ * List email logs (paginated).
+ *
+ * GET https://mailtrap.io/api/accounts/{account_id}/email_logs
+ */
+try {
+    // Get first page (no filters)
+    $response = $emailLogs->getList();
+    $data = ResponseHelper::toArray($response);
+
+    echo "Total count: " . $data['total_count'] . PHP_EOL;
+    foreach ($data['messages'] as $msg) {
+        echo "  - " . $msg['message_id'] . " | " . $msg['status'] . " | " . ($msg['subject'] ?? '') . PHP_EOL;
+    }
+
+    // Optional: filter by date range (last 2 days), recipient, categories – using the filters model
+    $sentBefore = (new DateTimeImmutable('now', new DateTimeZone('UTC')))->format(DateTimeInterface::ATOM);
+    $sentAfter = (new DateTimeImmutable('-2 days', new DateTimeZone('UTC')))->format(DateTimeInterface::ATOM);
+    $filters = EmailLogsListFilters::create(
+        $sentAfter,
+        $sentBefore,
+        [
+            'subject' => FilterCriterion::withoutValue(EmailLogsFilterOperator::NOT_EMPTY),
+            'to' => FilterCriterion::withValue(EmailLogsFilterOperator::CI_EQUAL, 'recipient@example.com'),
+            'category' => FilterCriterion::withValue(EmailLogsFilterOperator::EQUAL, ['Welcome Email', 'Order Confirmation']),
+        ]
+    );
+    $response = $emailLogs->getList($filters);
+    $data = ResponseHelper::toArray($response);
+
+    // Next page (use next_page_cursor from previous response)
+    $cursor = $data['next_page_cursor'] ?? null;
+    if ($cursor !== null) {
+        $response = $emailLogs->getList($filters, $cursor);
+        $data = ResponseHelper::toArray($response);
+    }
+} catch (Exception $e) {
+    echo 'Caught exception: ', $e->getMessage(), PHP_EOL;
+}
+
+/**
+ * Get a single email log message by ID.
+ *
+ * GET https://mailtrap.io/api/accounts/{account_id}/email_logs/{sending_message_id}
+ */
+try {
+    $listResponse = $emailLogs->getList();
+    $listData = ResponseHelper::toArray($listResponse);
+    $messageId = isset($listData['messages'][0]) ? $listData['messages'][0]['message_id'] : null;
+
+    if ($messageId !== null) {
+        $response = $emailLogs->getMessage($messageId);
+        $message = ResponseHelper::toArray($response);
+
+        echo "Message: " . $message['message_id'] . PHP_EOL;
+        echo "Status: " . $message['status'] . PHP_EOL;
+        echo "Subject: " . ($message['subject'] ?? '') . PHP_EOL;
+        echo "Events: " . count($message['events'] ?? []) . PHP_EOL;
+    } else {
+        echo "No messages in the list." . PHP_EOL;
+    }
+} catch (Exception $e) {
+    echo 'Caught exception: ', $e->getMessage(), PHP_EOL;
+}
diff --git a/examples/sending/minimal.php b/examples/sending/minimal.php
@@ -5,7 +5,7 @@
 use Mailtrap\Mime\MailtrapEmail;
 use Symfony\Component\Mime\Address;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 
 /**

diff --git a/examples/sending/suppressions.php b/examples/sending/suppressions.php
@@ -6,7 +6,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapSendingClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); // Your API token from https://mailtrap.io/api-tokens

diff --git a/examples/sending/template.php b/examples/sending/template.php
@@ -7,7 +7,7 @@
 use Symfony\Component\Mime\Email;
 use Symfony\Component\Mime\Header\UnstructuredHeader;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 
 /**

diff --git a/examples/templates/all.php b/examples/templates/all.php
@@ -7,7 +7,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapGeneralClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); // Your API token from https://mailtrap.io/api-tokens

diff --git a/examples/testing/attachments.php b/examples/testing/attachments.php
@@ -4,7 +4,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapSandboxClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $inboxId = $_ENV['MAILTRAP_INBOX_ID'];

diff --git a/examples/testing/inboxes.php b/examples/testing/inboxes.php
@@ -5,7 +5,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapSandboxClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/testing/messages.php b/examples/testing/messages.php
@@ -4,7 +4,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapSandboxClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 // your API token from here https://mailtrap.io/api-tokens
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];

diff --git a/examples/testing/projects.php b/examples/testing/projects.php
@@ -4,7 +4,7 @@
 use Mailtrap\Helper\ResponseHelper;
 use Mailtrap\MailtrapSandboxClient;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 $accountId = $_ENV['MAILTRAP_ACCOUNT_ID'];
 $config = new Config($_ENV['MAILTRAP_API_KEY']); #your API token from here https://mailtrap.io/api-tokens

diff --git a/examples/testing/send-mail.php b/examples/testing/send-mail.php
@@ -6,7 +6,7 @@
 use Symfony\Component\Mime\Address;
 use Symfony\Component\Mime\Header\UnstructuredHeader;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 
 /**

diff --git a/examples/testing/template.php b/examples/testing/template.php
@@ -6,7 +6,7 @@
 use Symfony\Component\Mime\Address;
 use Symfony\Component\Mime\Header\UnstructuredHeader;
 
-require __DIR__ . '/../vendor/autoload.php';
+require __DIR__ . '/../../vendor/autoload.php';
 
 
 /**