Status Codes
Understanding check results.
Success States
Success
Credentials are valid. The email and password combination works.
- Output:
success.txt - Action: None required
Invalid States
InvalidCredentials
The password is incorrect for this email.
- Output:
invalid.txt - Action: Password may be wrong or changed
TwoFactorRequired
The account has 2FA/MFA enabled and requires a second factor.
- Output:
2fa.txt - Action: Cannot validate without 2FA code
AccountLocked
The account is disabled, suspended, or blocked.
- Output:
locked.txt - Action: Account requires recovery
PasswordChangeRequired
The password has expired and must be changed.
- Output:
password_change.txt - Action: Password reset required
RecoveryRequired
Account requires identity verification before access.
- Output:
recovery.txt - Action: Manual recovery needed
CaptchaRequired
The server requires CAPTCHA verification.
- Output:
captcha.txt - Action: Cannot automate, try later
Temporary Errors
These may succeed on retry:
RateLimited
Server is throttling requests. Too many attempts.
- Output:
rate_limited.txt - Retry: Yes (with delay)
ConnectionFailed
Could not connect to the mail server.
- Output:
errors.txt - Retry: Yes
Timeout
Connection or response timed out.
- Output:
errors.txt - Retry: Yes
ProxyError
Proxy connection failed.
- Output:
errors.txt - Retry: Yes (different proxy)
TlsError
SSL/TLS handshake failed.
- Output:
errors.txt - Retry: Yes
Permanent Errors
These will not succeed on retry:
ServerNotFound
No mail server found for this domain.
- Output:
errors.txt - Retry: No
ProtocolError
Protocol-level error occurred.
- Output:
errors.txt - Retry: No
ProtocolMismatch
The server doesn’t support available protocols.
- Output:
errors.txt - Retry: No
Summary Table
| Status | Retryable | Output File |
|---|---|---|
| Success | - | success.txt |
| InvalidCredentials | No | invalid.txt |
| TwoFactorRequired | No | 2fa.txt |
| AccountLocked | No | locked.txt |
| RateLimited | Yes* | rate_limited.txt |
| CaptchaRequired | No | captcha.txt |
| PasswordChangeRequired | No | password_change.txt |
| RecoveryRequired | No | recovery.txt |
| ConnectionFailed | Yes | errors.txt |
| Timeout | Yes | errors.txt |
| ProxyError | Yes | errors.txt |
| TlsError | Yes | errors.txt |
| ProtocolError | No | errors.txt |
| ServerNotFound | No | errors.txt |
*RateLimited retries have special handling with backoff delays.