DocumentationEmail logs

Email logs

GET /emails/logs — paginated send history for your tenant.

Query transactional send history for the current tenant.

GET https://api.mailingcore.com/emails/logs?page=1&limit=20
Authorization: Bearer <JWT>
X-Tenant-Id: clxxxxxxxx

Auth: JWT + X-Tenant-Id (dashboard session). API keys with scope email:read can also call this endpoint when used from the SDK.

Query parameters

ParameterDefaultDescription
page1Page number (1-based)
limit20Items per page

Response

{
  "data": [
    {
      "id": "clxlog...",
      "toEmail": "[email protected]",
      "subject": "Welcome",
      "status": "SENT",
      "provider": "ses",
      "messageId": "0100018...",
      "createdAt": "2026-06-20T10:00:00.000Z",
      "tags": ["welcome"]
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 1523,
    "totalPages": 77
  }
}

SDK

import { MailingCore } from 'mailingcore-js'

MailingCore.init({ apiKey: process.env.MAILINGCORE_API_KEY! })

const { data, meta } = await MailingCore.getLogs({ page: 1, limit: 20 })

Related