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.

Billing

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}

Query Parameters

{
  "status": "success",
  "result": "valid",
  "format": "valid",
  "server_status": "success",
  "email_id": 8354,
  "valid_dns_record": 1,
  "valid_mx_record": 1,
  "reachable_smtp_server": 1,
  "fqdn": "google.com",
  "type": "professional"
}

Get single verify status

GET https://app.truemail.io/api/v1/verify/status?access_token={api_key}&email_id={email_id}

This endpoint enables you to get a single verify status.

Query Parameters

{
  "status": "success",
  "result": "valid",
  "format": "valid",
  "server_status": "success",
  "email_id": 8354,
  "valid_dns_record": 1,
  "valid_mx_record": 1,
  "reachable_smtp_server": 1,
  "fqdn": "google.com",
  "type": "professional"
}

The Timeout Parameter

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.

Usage Guidelines

Please be sure to review our usage guidelines for the API here.

Handling Aliases

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.

Result Codes

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.

Flags

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.

Last updated