Sandbox & IP Blocks
In sandbox mode you can test your integration without consuming credits or affecting production data. For API keys with sandbox flag, only the emails below are available for test — and the rest are defaulted to white category and unknown type.
| Category | Type | |
|---|---|---|
test@disposable.com | black | disposable |
test@multi-alias.com | grey | multi-alias services |
test@gmail.com | white | — |
Switching to active mode
When you're ready for production:
- Go to your dashboard
- Toggle your API key to active mode or create a new one for production server
- Deploy your app
IP Blocks
IP banning applies to real-time validation calls only and is disabled in sandbox mode.
Every response for a black-category email includes a remaining_attempts_before_ban counter.
The counter starts at the configured threshold (default: 5, adjustable between 3 and 5) and decrements with each black-category result from that IP. When it reaches 0, the IP is permanently banned and all subsequent requests return:
{
"detail": "Your IP address is banned. Contact the service administrator to unlock access."
}The threshold can be adjusted from your color configuration page.
Banned IPs can be manually unblocked from your API settings page — the banned IP address will be listed there.