VOID MAIL API

// DEVELOPER REFERENCE v1.0 — vrus.shop
BASE URL: http://localhost/voidmail/api.php
ALL endpoints require authentication via API key.
Pass header: X-API-Key: YOUR_KEY or query param ?api_key=YOUR_KEY
YOUR API KEY: vm_69ff041e7067a4689ee17e88f6ddb01039ef0e9165fcc06b5053e6a3f19aa694
// Endpoints
GET?action=generate
Generate a new random temporary email address
curl "http://localhost/voidmail/api.php?action=generate&api_key=YOUR_KEY" Response: { "success": true, "email": "ab3kx9z2mn@vrus.shop", "domain": "vrus.shop" }
GET?action=inbox&email=ADDRESS
Fetch all emails received by a specific address
emailstringFull email address @vrus.shop
curl "http://localhost/voidmail/api.php?action=inbox&email=test@vrus.shop&api_key=KEY" Response: { "success": true, "email": "test@vrus.shop", "count": 2, "messages": [ { "id": 5, "from": "Kick", "from_email": "noreply@kick.com", "subject": "Your verification code", "date": "2026-06-04 03:44:00", "date_ts": 1749005040, "text": "Your code is 289487" } ] }
GET?action=message&email=ADDRESS&id=ID
Get full message content including HTML body
emailstringEmail address
idintMessage ID from inbox
GET?action=check&email=ADDRESS
Check if email has new messages (lightweight, use for polling)
Response: { "success": true, "email": "x@vrus.shop", "count": 3 }