Base URL: https://mailprobe.grabshot.dev/v1
Pass your API key via the x-api-key header or api_key query parameter.
curl https://mailprobe.grabshot.dev/v1/[email protected] \
-H "x-api-key: mp_your_api_key"/v1/verify?email={email}
Verify a single email address. Returns validity, quality score, and detailed checks.
{
"email": "[email protected]",
"valid": true,
"score": 90,
"quality": "high",
"checks": {
"syntax": true,
"disposable": false,
"role_based": false,
"free_provider": true,
"mx_valid": true,
"mx_records": [
{ "host": "gmail-smtp-in.l.google.com", "priority": 5 }
]
},
"timestamp": "2026-03-02T01:00:00.000Z"
}| 80-100 | High - Safe to send |
| 60-79 | Medium - Proceed with caution |
| 40-59 | Low - Consider removing |
| 0-39 | Invalid - Do not send |
/v1/verify/bulk
Verify up to 100 emails in a single request.
{
"emails": ["[email protected]", "[email protected]", "[email protected]"]
}{
"total": 3,
"valid": 1,
"invalid": 2,
"results": [ ... ]
}/v1/usage
{
"plan": "free",
"usage": 12,
"limit": 50,
"remaining": 38,
"resets_at": "2026-04-01T00:00:00.000Z",
"rate_limit": "5/minute"
}/v1/register
curl -X POST https://mailprobe.grabshot.dev/v1/register \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "password": "your_password"}'
// Response: { "api_key": "mp_...", "plan": "free" }| 401 | Invalid or missing API key |
| 429 | Rate limit or monthly quota exceeded |
| 400 | Missing required parameters |
| 500 | Server error |