Detect Disposable

Check if an email address is from a disposable email provider

get/detect-disposable

Request

  • Base URL: https://api.minelead.io/v1
  • URL: https://api.minelead.io/v1/detect-disposable
  • Auth: API key in query parameter key

Query parameters

keystring required
Example:myApiKey

Your API key

emailstring required
Example:test@10minutemail.com

The email address to check

Response

Disposable email detection result

statusstring

Request status

emailstring

The email address that was checked

disposability_scorenumber

Score indicating disposability level (0-5, higher is more disposable)

format_validboolean

Whether the email format is valid

spam_scorestring

Spam score assessment

domain_type'business' | 'personal'

Type of domain

disposable_status'Disposable' | 'Not Disposable' | 'Unknown'

User-friendly disposable status for UI display

a_record_status'Present' | 'Missing' | 'Unknown'

User-friendly A record status for UI display

ptr_record_status'Present' | 'Missing' | 'Unknown'

User-friendly PTR record status for UI display

mx_record_status'Present' | 'Missing' | 'Unknown'

User-friendly MX record status for UI display

timestampnumber

Timestamp of the check

Example response

{
  "status": "success",
  "email": "test@10minutemail.com",
  "disposability_score": 4,
  "format_valid": true,
  "spam_score": "NA",
  "domain_type": "business",
  "disposable_status": "Disposable",
  "a_record_status": "Missing",
  "ptr_record_status": "Missing",
  "mx_record_status": "Present",
  "timestamp": 1625832452.123
}

Changes

No recorded changes to this operation across all 1 revision of this API.