You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| is_free | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: True, False |
44
+
| is_syntax | Whether the email address is syntactically correct. Return values: True, False |
45
+
| is_domain | Whether the email address has a valid MX record in its DNS entries. Return values: True, False, - (- means not applicable) |
46
+
| is_smtp | Whether the mail servers specified in the MX records are responding to connections. Return values: True, False, - (- means not applicable) |
47
+
| is_verified | Whether the mail server confirms that the email address actually exist. Return values: True, False, - (- means not applicable) |
48
+
| is_server_down | Whether the mail server is currently down or unresponsive. Return values: True, False, - (- means not applicable) |
49
+
| is_greylisted | Whether the mail server employs greylisting where an email has to be sent a second time at a later time. Return values: True, False, - (- means not applicable) |
50
+
| is_disposable | Whether the email address is a temporary one from a disposable email provider. Return values: True, False, - (- means not applicable) |
51
+
| is_suppressed | Whether the email address is in our blacklist. Return values: True, False, - (- means not applicable) |
52
+
| is_role | Whether the email address is a role-based email address like [email protected] or [email protected]. Return values: True, False, - (- means not applicable) |
53
+
| is_high_risk | Whether the email address contains high risk keywords. Return values: True, False, - (- means not applicable) |
54
+
| is_catchall | Whether the email address is a catch-all address. Return values: True, False, Unknown, - (- means not applicable) |
55
+
| mailboxvalidator_score | Email address reputation score. Score > 0.70 means good; score > 0.40 means fair; score <= 0.40 means poor. |
56
+
| time_taken | The time taken to get the results in seconds. |
57
+
| status | Whether our system think the email address is valid based on all the previous fields. Return values: True, False |
58
+
| credits_available | The number of credits left to perform validations. |
59
+
| error_code | The error code if there is any error. See error table in the below section. |
60
+
| error_message | The error message if there is any error. See error table in the below section. |
61
+
62
+
## disposable_email(email_address)
63
+
64
+
Checks if the supplied email address is from a disposable email provider.
65
+
66
+
### Return Fields
67
+
68
+
| Field Name | Description |
69
+
|-----------|------------|
70
+
| email_address | The input email address. |
71
+
| is_disposable | Whether the email address is a temporary one from a disposable email provider. Return values: True, False |
72
+
| credits_available | The number of credits left to perform validations. |
73
+
| error_code | The error code if there is any error. See error table in the below section. |
74
+
| error_message | The error message if there is any error. See error table in the below section. |
75
+
76
+
## free_email(email_address)
77
+
78
+
Checks if the supplied email address is from a free email provider.
79
+
80
+
### Return Fields
81
+
82
+
| Field Name | Description |
83
+
|-----------|------------|
84
+
| email_address | The input email address. |
85
+
| is_free | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: True, False |
86
+
| credits_available | The number of credits left to perform validations. |
87
+
| error_code | The error code if there is any error. See error table in the below section. |
88
+
| error_message | The error message if there is any error. See error table below. |
89
+
90
+
# Sample Code
91
+
92
+
Validate email
93
+
--------------------------
28
94
29
95
```ruby
30
96
require"mailboxvalidator_ruby"
@@ -64,131 +130,8 @@ end
64
130
65
131
```
66
132
67
-
Functions
68
-
=========
69
-
70
-
### new()
71
-
72
-
Creates a new instance of the MailboxValidator object.
73
-
74
-
### query_single(email_address)
75
-
76
-
Performs email validation on the supplied email address.
77
-
78
-
Result Fields
79
-
=============
80
-
81
-
### email_address
82
-
83
-
The input email address.
84
-
85
-
### domain
86
-
87
-
The domain of the email address.
88
-
89
-
### is_free
90
-
91
-
Whether the email address is from a free email provider like Gmail or Hotmail.
92
-
93
-
Return values: True, False
94
-
95
-
### is_syntax
96
-
97
-
Whether the email address is syntactically correct.
98
-
99
-
Return values: True, False
100
-
101
-
### is_domain
102
-
103
-
Whether the email address has a valid MX record in its DNS entries.
104
-
105
-
Return values: True, False, - (- means not applicable)
106
-
107
-
### is_smtp
108
-
109
-
Whether the mail servers specified in the MX records are responding to connections.
110
-
111
-
Return values: True, False, - (- means not applicable)
112
-
113
-
### is_verified
114
-
115
-
Whether the mail server confirms that the email address actually exist.
116
-
117
-
Return values: True, False, - (- means not applicable)
118
-
119
-
### is_server_down
120
-
121
-
Whether the mail server is currently down or unresponsive.
122
-
123
-
Return values: True, False, - (- means not applicable)
124
-
125
-
### is_greylisted
126
-
127
-
Whether the mail server employs greylisting where an email has to be sent a second time at a later time.
128
-
129
-
Return values: True, False, - (- means not applicable)
130
-
131
-
### is_disposable
132
-
133
-
Whether the email address is a temporary one from a disposable email provider.
134
-
135
-
Return values: True, False, - (- means not applicable)
136
-
137
-
### is_suppressed
138
-
139
-
Whether the email address is in our blacklist.
140
-
141
-
Return values: True, False, - (- means not applicable)
0 commit comments