API referenceEmail
List simulated events for test-mode sends
GET
Events generated by test_mode/X-Relay-Test sends only (joined against messages.test_mode = 1). Cursor is the bare epoch-ms created_at of the last row returned.
bearerAuthheader
AuthorizationBearer <token>API key sent as Authorization: Bearer <key>. Looked up by SHA-256
hash (email_core::sha256_hex) against api_keys.hash; revoked
keys and keys belonging to a suspended tenant are rejected. See the
top-level Authentication section for permission levels.
limit?integerMax rows to return.
Range
1 <= value <= 100Default
25cursor?integerReturn rows strictly older than this epoch-ms timestamp.
Format
int64Test event list.
application/json- response
data?array<>next_cursor?|Format
int64curl -X GET "https://example.com/v1/email/test-events"{ "data": [ { "id": "string", "message_id": "string", "type": "string", "payload": "string", "created_at": 0 } ], "next_cursor": 0}