Skip to main content

GET /emails/logs

Retrieve a paginated list of sent emails.

Authentication

JWT (Dashboard) or API Key

Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number
limitnumber50Results per page (max 100)
domain_idstringFilter by domain UUID
statusstringFilter by status: pending, sent, delivered, bounced, complained, failed
API key requests only see emails for that key’s domain. JWT requests see all domains.

Response

{
  "success": true,
  "data": {
    "emails": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "from_email": "you@yourdomain.com",
        "to_emails": ["user@example.com"],
        "subject": "Hello",
        "status": "delivered",
        "open_count": 1,
        "click_count": 0,
        "created_at": "2026-03-07T12:00:00Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 50,
      "total": 142,
      "totalPages": 3
    }
  }
}

Example

curl "https://app.usesendi.com/api/emails/logs?page=1&limit=20&status=delivered" \
  -H "Authorization: Bearer snd_your_api_key"