List events

Browse the recent event log. Useful for ad-hoc triage when you want to see what’s happening without setting up a webhook.


GET /api/v1/partner/email/events

Query parameters

Field	Type	Notes
`day_bucket`	string	`YYYY-MM-DD` UTC. Default: today
`event_type`	string	Filter by event type (lowercase)
`limit`	int	1-1000, default 200

Response


{
  "success": true,
  "events": [
    {
      "event_id": "e_550e8400-...",
      "event_type": "delivered",
      "message_id": "550e8400-...",
      "config_set_id": "cs_...",
      "recipient": "customer@example.com",
      "created_at": "2026-05-03T12:34:57Z"
    },
    {
      "event_id": "e_660e8400-...",
      "event_type": "bounce",
      "message_id": "660e8400-...",
      "recipient": "deadbox@example.com",
      "bounce_type": "Permanent",
      "bounce_reason": "no_such_user",
      "created_at": "2026-05-03T12:35:01Z"
    },
    {
      "event_id": "e_770e8400-...",
      "event_type": "click",
      "message_id": "...",
      "recipient": "...",
      "url": "https://yourapp.com/dashboard",
      "ip": "203.0.113.42",
      "ua": "Mozilla/5.0 ...",
      "created_at": "..."
    }
  ],
  "count": 3,
  "day_bucket": "2026-05-03"
}

cURL


curl 'https://apis.splashifypro.com/api/v1/partner/email/events?day_bucket=2026-05-03&event_type=bounce&limit=100' \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"

Webhooks vs this endpoint

For push-based event delivery, use webhooks. This endpoint is for ad-hoc reads — debugging, auditing, replaying a window of events into your own database.

Note: only the last 30 days of events are retained. For long-term archival, persist them at your end via webhooks.