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
Response
json
{
"success": true,
"events": [
{
"event_id": "e_550e8400-...",
"event_type": "delivered",
"message_id": "550e8400-...",
"config_set_id": "cs_...",
"recipient": "[email protected]",
"created_at": "2026-05-03T12:34:57Z"
},
{
"event_id": "e_660e8400-...",
"event_type": "bounce",
"message_id": "660e8400-...",
"recipient": "[email protected]",
"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
bash
curl 'https://api.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.