Single Verification
Single verification let you verify single emails and catch additional information relate to the email.
Our API can be easily integrated into your signup or onboarding process with just one request.
Each verification performed over the
Single
endpoints cost 1 credit. Duplicate verifications requests and bad syntax data are included.get
https://app.truemail.io
/api/v1/verify/single?access_token={api_key}&email={email}
get
https://app.truemail.io
/api/v1/verify/status?access_token={api_key}&email_id={email_id}
Get single verify status
The timeout parameter informs the API for how much time it needs to verify an email before giving up and coming back with an
unknown
result code. The total request time can exceed this timeout, as network latency is not taken into consideration. This can be helpful when verifying emails at the point of entry to prevent long wait times for your users.When verifying emails that contain aliases that use a
+
character extra consideration needs to be taken when encoding these for x-www-form-urlencoded
content-types. Make sure this character is being encoded as %2B
, as the +
character is treated as a non-breaking space when the string is decoded.The
result
property contains a string that correlates to a result codes listed in the table below. For detailed information about result codes visit our help center.Result Code | Description |
valid | Verified as real address |
invalid | Verified as not valid |
disposable | A temporary, disposable address |
catchall | A domain wide-setting, also known as Accept-all |
unknown | The server cannot be reached |
| |
The flags give you extra data that was found out about the domain during verification. Below is a list of common flags you can face.
Flag | Description |
has_dns | The input has one or more DNS records associated with the hostname. |
has_dns_mx | The input has mail exchanger DNS records configured. |
bad_syntax | The input given doesn't appear to be an email. |
disposable_email | The input given is a disposable email. |
spelling_mistake | The input was misspelled |
role_account | This email is a role-based email address |
connect_fails | Unable to connect to remote host. |
international_host | INT designated domain names. |
accepts_all | Remote host accepts mail at any address. |
contains_alias | The email address supplied contains an address part and an alias part. |
acedemic_host | The input given is a acedemic email. |
Last modified 2mo ago