Every check in one response.
One call returns the facts and a result your code can branch on: pass, warn, or fail, with a one-line reason. Your project's Lead Screen settings decide what counts against an address, so the API and your forms agree.
Branch on the result
Facts plus a pass, warn, or fail
curl https://goodinbound.com/api/v1/leadscreen/checks \
-H "Authorization: Bearer $GOODINBOUND_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"fields": {"email": "jane@mailinator.com"}}'
{
"action": "screen_out",
"checks": {
"identity": { "result": "fail", "summary": "Disposable email" }
},
"email": {
"domain": "mailinator.com",
"valid": true,
"disposable": true,
"free": false,
"role": false,
"mx": null,
"work": false
}
}
Disposable and free providers
Matched against more than 9,000 temporary-inbox domains and 5,000 free providers like Gmail and Outlook.
Role and gibberish addresses
Flags shared inboxes like info@ and sales@, and keyboard mashes before the @.
Mail server and domain age
Checks the domain's MX records, and its registration date when you turn on the new-domains rule.



