Every mistyped email address is a person you meant to reach — and lost. Someone signs up as email@mai.ru, the confirmation message goes nowhere, and the customer who wanted to hear from you never does. They rarely notice the typo; they just conclude your emails never arrived.
CleanContact turns those near-misses into saves. When a check comes back Bad or Unknown and the domain looks like a slip of the keyboard, the response includes a suggest field with the address the user most likely meant. You stay in control: the verdict is unchanged, and the suggestion is yours to show, apply, or ignore.
Example
Validate a mistyped address the usual way:
curl -H "X-API-Key: <your-key>" \
"https://api.cleancontact.ru/validate?email=email@mai.ru"The verdict is honest — the address really is Bad — but the response also offers the likely correction:
{
"value": "email@mai.ru",
"result": {
"status": "Bad",
"detail": "Domain has no MX records"
},
"suggest": ["email@mail.ru"]
}What it does for you
- Catch typos at the door — show a “Did you mean email@mail.ru?” prompt right on your signup form, before the wrong address ever enters your database.
- Recover contacts instead of just rejecting them — a Bad verdict becomes a second chance rather than a dead end.
- Fewer silent losses — fewer support tickets about missing confirmation emails, fewer customers who quietly never hear from you.
Suggestions are drawn from a curated list of trusted mail providers, so you will never be pointed at a disposable or look-alike domain. The field appears only when there is something worth suggesting — for every other result the response stays exactly as before.
The feature is on for every API key, with nothing to configure. If the suggest field is present, show it to your user — it is usually exactly what they meant to type.