Email Insights
Data Validation & Fraud Prevention

{
  "emailAddress": "tatak17923@filipx.com",
  "emailProvider": "Temp-mail",   // Google, Microsoft, YopMail
  "emailType": "disposable",      // free, disposable, private
  "isDeliverable": "yes",         // yes, no, unknown
  "isMailboxFull": false,
  "isCatchAll": true,
  "isFormatValid": true,
  "emailCorrection": "",
  "isReachable": true,
  "riskReport": {
    "score": 1000,                // 200–1000 (higher = riskier)
    "level": "highest",           // "lowest" | "low" | "medium" | "high" | "highest"
    "baseAnalysis": [
      "blocklisted-domain",
      "disposable-domain",
      "spoofing-risk"
    ]
  },
  "addressSignals": {
    "tagDetected": false,         // plus-addressing present (user+tag@)
    "tagValue": "",
    "normalizedAddress": "tatak17923@filipx.com",
    "isRoleAddress": false,       // role/shared inbox (support, sales, etc.)
    "roleType": "",               // "support" | "sales" | "info" | ... | "other"
    "isNoReply": false,           // no-reply address detected
    "noReplyPattern": ""
  },
  "emailDNS": {
    "mx": [
      "10 mail.wallywatts.com",
      "10 mail.wabblywabble.com"
    ],
    "spfValid": true,
    "dkimConfigured": false,
    "dmarcValid": false,
    "mxRelay": false,              // true = uses/behaves like a relay service
    "mxRelayCategory": ""          // 'cloud-routing' 'alias-forwarded' 'security-gateway' 'transactional-relay'
  },
  "domain": {
    "name": "filipx.com",
    "enrichmentAvailable": true,
    "creationDate": "2015-08-23T18:02:54.000Z",
    "expirationDate": "2026-08-23T18:02:54.000Z",
    "updatedDate": "2025-09-23T15:34:43.000Z",
    "ageYears": 10,
    "registrar": "NameSilo, LLC",
    "isBlockListed": true,       // domain flagged by one or more well-known sources (DBL)
    "mtaStsStatus": "unknown",   // "present" | "invalid" | "absent" | "unknown" (domain-level)
    "bimiStatus": "unknown",     // "present" | "present-no-vmc" | "invalid" | "absent" | "unknown"
    "hasVMC": false,
    "aRecordValid": false,
    "aRecordReverseHost": "",
    "sslValid": false
  }
}

import { EmailInsights } from '@opportify/sdk-nodejs';

const clientEmailInsights = new EmailInsights({
  version: '1.0',
  apiKey: 'YOUR_API_KEY'
});

async function analyzeEmail() {
  try {
    const response = await clientEmailInsights.analyze({
      email: "email_to_validate@domain.com",
      enableAutoCorrection: true,
      enableAI: true, // only available on paid plans.
    });
    console.log('response', response);
  } catch (error: unknown) {
    console.error('error', error);
  }
}

analyzeEmail();

use Opportify\Sdk\EmailInsights;

$emailInsights = new EmailInsights("YOUR-API-KEY-HERE");

$params = [
    "email" => "test@gmail.com",
    "enableAi" => true,
    "enableAutoCorrection" => true
];

$result = $emailInsights->analyze($params);

// Import classes:
import ai.opportify.client.ApiClient;
import ai.opportify.client.ApiException;
import ai.opportify.client.Configuration;
import ai.opportify.client.auth.*;
import ai.opportify.client.model.*;
import ai.opportify.client.api.EmailInsightsApi;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    defaultClient.setBasePath("https://api.opportify.ai/insights/v1");

    // Configure API key authorization: opportifyToken
    ApiKeyAuth opportifyToken = (ApiKeyAuth) defaultClient.getAuthentication("opportifyToken");
    opportifyToken.setApiKey("YOUR API KEY");

    EmailInsightsApi apiInstance = new EmailInsightsApi(defaultClient);
    AnalyzeEmailRequest analyzeEmailRequest = new AnalyzeEmailRequest();
    analyzeEmailRequest.email("email_to_validate@domain.com");
    analyzeEmailRequest.enableAutoCorrection(true);
    analyzeEmailRequest.enableAI(true); // only available for paid plans.
    try {
      AnalyzeEmail200Response result = apiInstance.analyzeEmail(analyzeEmailRequest);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling EmailInsightsApi#analyzeEmail");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}

from opportify_sdk import EmailInsights

# Initialize the wrapper with your API key
api_key = "<YOUR-API-KEY-HERE>"
email_insights = EmailInsights(api_key)

# Optional: Configure host, version, and debug mode
email_insights.set_version("v1")

# Define request parameters
params = {
    "email": "<SOME-EMAIL-HERE>",
    "enableAutoCorrection": True,
    "enableAi": True
}

# Call the API
try:
    result = email_insights.analyze(params)
    print("Response:", result)
except Exception as e:
    print(f"Error: {e}")