API Documentation
Read disposable inboxes programmatically. Public endpoints return JSON and require no account.
Base URL: https://sufreveals.tech
Email endpoints
GET/api/mail/messages?to={email}&page=1&limit=20
Retrieve paginated messages for an address.
curl "https://sufreveals.tech/api/mail/messages?to=test@sufreveals.tech&page=1&limit=20"
GET/api/mail/count?to={email}
Return a lightweight change token for efficient polling.
{"token":"K3auEpcZ"}DELETE/api/mail/delete?to={email}
Delete all messages for an address.
Domain endpoints
GET/api/domains/active
Return active disposable-email domains.
["sufreveals.tech"]
GET/api/domains/check-dns?domain={domain}
Verify that a domain's MX record points to this service.
POST/api/domains
Verify and activate a custom domain.
curl -X POST https://sufreveals.tech/api/domains \
-H 'Content-Type: application/json' \
-d '{"domain":"example.com"}'Limits and retention
| Item | Value |
|---|---|
| Authentication | None for public inbox endpoints |
| Maximum page size | 100 messages |
| Maximum message size | 10 MiB |
| Polling interval | 5 seconds recommended |
| Retention | 24 hours |