​

Getting Started

Abstract’s Email Reputation API requires only your unique API key api_key and a single email email:

https://emailreputation.abstractapi.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith@gmail.com

This was a successful request, and all available details about that email were returned:

{
  "email_address": "benjamin.richard@abstractapi.com",
  "email_deliverability": {
    "status": "deliverable",
    "status_detail": "valid_email",
    "is_format_valid": true,
    "is_smtp_valid": true,
    "is_mx_valid": true,
    "mx_records": [
      "gmail-smtp-in.l.google.com",
      "alt3.gmail-smtp-in.l.google.com",
      "alt4.gmail-smtp-in.l.google.com",
      "alt1.gmail-smtp-in.l.google.com",
      "alt2.gmail-smtp-in.l.google.com"
    ]
  },
  "email_quality": {
    "score": 0.8,
    "is_free_email": false,
    "is_username_suspicious": false,
    "is_disposable": false,
    "is_catchall": true,
    "is_subaddress": false,
    "is_role": false,
    "is_dmarc_enforced": true,
    "is_spf_strict": true,
    "minimum_age": 1418
  },
  "email_sender": {
    "first_name": "Benjamin",
    "last_name": "Richard",
    "email_provider_name": "Google",
    "organization_name": "Abstract API",
    "organization_type": "company"
  },
  "email_domain": {
    "domain": "abstractapi.com",
    "domain_age": 1418,
    "is_live_site": true,
    "registrar": "NAMECHEAP INC",
    "registrar_url": "http://www.namecheap.com",
    "date_registered": "2020-05-13",
    "date_last_renewed": "2024-04-13",
    "date_expires": "2025-05-13",
    "is_risky_tld": false
  },
  "email_risk": {
    "address_risk_status": "low",
    "domain_risk_status": "low"
  },
  "email_breaches": {
    "total_breaches": 2,
    "date_first_breached": "2018-07-23T14:30:00Z",
    "date_last_breached": "2019-05-24T14:30:00Z",
    "breached_domains": [
      { "domain": "apollo.io", "date_breached": "2018-07-23T14:30:00Z" },
      { "domain": "canva.com", "date_breached": "2019-05-24T14:30:00Z" }
    ]
  }
}

​

Request parameters

​

Response parameters

The API response is returned in a universal and lightweight JSON format.

​

Request examples

​

Checking a malformed email

In the example below, we show the request and response for an email does not follow the proper format. If the email fails the is_format_valid check, then the other checks will not be performed and will be returned as false

https://emailreputation.abstractapi.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith

The request was valid and successful, and so it returns the following:

{
  "email_address": "johnsmith",
  "email_deliverability": {
    "status": "undeliverable",
    "status_detail": "invalid_format",
    "is_format_valid": false,
    "is_smtp_valid": false,
    "is_mx_valid": false,
    "mx_records": []
  },
  "email_quality": {
    "score": null,
    "is_free_email": null,
    "is_username_suspicious": null,
    "is_disposable": null,
    "is_catchall": null,
    "is_subaddress": null,
    "is_role": null,
    "is_dmarc_enforced": null,
    "is_spf_strict": null,
    "minimum_age": null
    },
  "email_sender": {
    "first_name": null,
    "last_name": null,
    "email_provider_name": null,
    "organization_name": null,
    "organization_type": null
  },
  "email_domain": {
    "domain": null,
    "domain_age": null,
    "is_live_site": null,
    "registrar": null,
    "registrar_url": null,
    "date_registered": null,
    "date_last_renewed": null,
    "date_expires": null,
    "is_risky_tld": null
  },
  "email_risk": {
    "address_risk_status": null,
    "domain_risk_status": null
  },
  "email_breaches": {
    "total_breaches": null,
    "date_first_breached": null,
    "date_last_breached": null,
    "breached_domains": []
  }
}

​

Possible values for status_detail

This field provides more information about the deliverability result.

​

When status is deliverable:

• valid_email: The email address exists, is valid, and can receive new emails.
• high_traffic_email: The email is valid and exists, but the server is receiving too many messages. Your email might bounce.

​

When status is undeliverable:

• invalid_mailbox: The email address doesn’t exist or is no longer active. It can’t receive new emails.
• full_mailbox: The email exists but its mailbox is full, so new emails will bounce.
• invalid_format: The email doesn’t follow the correct format (e.g., missing @ or domain).
• dns_record_not_found: We couldn’t find MX records for the domain, so we couldn’t complete the SMTP check.
• unavailable_server: The mail server for the domain is currently unreachable.

​

When status is unknown:

• null

​

Bulk upload (CSV)

Don’t know how to or don’t want to make API calls? Use the bulk CSV uploader to easily use the API. The results will be sent to your email when ready.

Here are some best practices when bulk uploading a CSV file:

• Ensure the selected column contains the email addresses to be analyzed.
• Remove any empty rows from the file.
• Include only one email address per row.
• The maximum file size permitted is 50,000 rows.

​

Response and error codes

Whenever you make a request that fails for some reason, an error is returned also in the JSON format. The errors include an error code and description, which you can find in detail below.

​

Code samples and libraries

Please see the top of this page for code samples for these languages and more. If we’re missing a code sample, or if you’d like to contribute a code sample or library in exchange for free credits, email us at: team@abstractapi.com

​

Other notes

A note on metered billing: Each individual email you submit counts as a credit used. Credits are also counted per request, not per successful response. So if you submit a request for the (invalid) email address “kasj8929hs”, that still counts as 1 credit.