curl

curl -X POST https://verification.didit.me/v3/email/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "alice@example.com",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Email.AssessRisk(ctx, didit.EmailRiskRequest{
	Email: "alice@example.com",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.EmailRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.email().assessRisk(EmailRiskRequest.builder()
        .email("alice@example.com")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->email->assessRisk([
    'email' => 'alice@example.com',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Email.AssessRiskAsync(new EmailRiskRequest
{
    Email = "alice@example.com",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "82397be9-5921-4970-a979-2d5b43e08b33",
  "status": "Approved",
  "email": {
    "status": "Approved",
    "email": "alice@example.com",
    "is_breached": false,
    "breaches": [],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "email_intelligence": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    },
    "enrichment": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

ईमेल सत्यापन

ईमेल जोखिम API: डिलीवरेबिलिटी और ब्रीच संकेत

Didit के साथ बिना OTP भेजे ईमेल पते का जोखिम स्कोर पाएँ। डिलीवरेबिलिटी, डिस्पोज़ेबल डोमेन, ब्रीच और फ़्रॉड संकेत, एक सर्वर-से-सर्वर कॉल में।

POST

risk

curl

curl -X POST https://verification.didit.me/v3/email/risk/ \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "alice@example.com",
    "country_code": "US",
    "vendor_data": "lead-123",
    "metadata": {"source": "signup_prescreen"}
  }'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Email.AssessRisk(ctx, didit.EmailRiskRequest{
	Email: "alice@example.com",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;
import me.didit.types.EmailRiskRequest;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.email().assessRisk(EmailRiskRequest.builder()
        .email("alice@example.com")
        .build());
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->email->assessRisk([
    'email' => 'alice@example.com',
]);
print_r($result->toArray());

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Email.AssessRiskAsync(new EmailRiskRequest
{
    Email = "alice@example.com",
});
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "request_id": "82397be9-5921-4970-a979-2d5b43e08b33",
  "status": "Approved",
  "email": {
    "status": "Approved",
    "email": "alice@example.com",
    "is_breached": false,
    "breaches": [],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 0,
    "verified_at": null,
    "warnings": [],
    "lifecycle": [],
    "matches": [],
    "email_intelligence": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    },
    "enrichment": {
      "score": 4,
      "deliverable": "high",
      "breach_risk_level": "Low",
      "breach_risk_index": 4,
      "is_recent_breach": false,
      "is_frequent_breached": false,
      "is_disposable": false,
      "is_free_domain": false,
      "is_breached": false,
      "no_of_breaches": 0,
      "reason_codes": []
    }
  },
  "vendor_data": "lead-123",
  "metadata": {
    "source": "signup_prescreen"
  },
  "created_at": "2026-09-01T10:30:00.123456+00:00"
}

यह ईमेल नहीं भेजता। यह एक API सत्र बनाता है, पते को समृद्ध करता है, आपके ईमेल-जोखिम नियम लागू करता है, और एक ही सिंक्रोनस रिस्पॉन्स में वही सामान्यीकृत ईमेल ब्लॉक लौटाता है जो ईमेल सत्यापन में उपयोग होता है। जब अनुरोध सहेजा जाता है, तब Didit स्कोर किए गए ईमेल को Networks में समेकित साक्ष्य के रूप में भी उपयोग कर सकता है। नेटवर्क ग्राफ़ साझा ईमेल संकेतों पर उच्च-जोखिम ईमेल इंटेलिजेंस, उल्लंघन संदर्भ और सोशल-प्रोफ़ाइल कवरेज दिखा सकते हैं, लेकिन वे अन्य संगठनों को कच्चा ईमेल पता नहीं दिखाते। POST /v3/email/risk/ का उपयोग तब करें जब आपको उपयोगकर्ता से वन-टाइम कोड दर्ज करवाए बिना ईमेल इंटेलिजेंस चाहिए।

रिस्पॉन्स की व्याख्या

status इस API सत्र का अंतिम निर्णय है। यह आम तौर पर Approved होता है; जोखिम मूल्यांकन से In Review या Declined परिणाम भी आ सकता है।
email.is_breached, email.is_disposable और email.is_undeliverable एप्लिकेशन लॉजिक के लिए उपयोग होने वाले स्थिर हाँ/नहीं संकेत हैं।
email.breaches उस पते वाले सबसे हाल के ज्ञात उल्लंघनों की सूची देता है, जब कवरेज उपलब्ध हो, साथ में उल्लंघन की तिथि और उजागर हुए डेटा वर्ग।
email.email_intelligence.score 0-100 जोखिम पैमाने का उपयोग करता है, जहाँ अधिक संख्या का अर्थ अधिक जोखिम है। breach_risk_level (Low, Medium, High) और no_of_breaches व्युत्पन्न दृश्य हैं।
email.email_intelligence.reason_codes बताता है कि परिणाम में कौन से सामान्यीकृत संकेतों ने योगदान दिया। समय के साथ मान बढ़ सकते हैं, इसलिए अज्ञात कोड को अस्वीकार न करें।
email.email_intelligence और email.enrichment संगतता उपनाम हैं, जो एक ही सामान्यीकृत ऑब्जेक्ट को दर्शाते हैं। नए इंटीग्रेशन email.enrichment पढ़ सकते हैं।
email.matches आपके एप्लिकेशन के उन अन्य सत्रों की सूची देता है जहाँ यही पता किसी भिन्न उपयोगकर्ता ने उपयोग किया था। इसका उपयोग डुप्लिकेट खाता पहचान के लिए करें।
request_id API सत्र का आईडी है। यदि आपको परिणाम को बाद के webhook या कंसोल गतिविधि से जोड़ना है, तो इसे vendor_data के साथ सहेजें।

email.email_intelligence और email.enrichment सर्वोत्तम-प्रयास फ़ील्ड हैं। एक पूर्ण लुकअप में भी ये दोनों छूट सकते हैं, जब उस पते, डोमेन या प्लान के लिए कोई उपयोगी इंटेलिजेंस डेटा न मिले। पहले is_breached, is_disposable और is_undeliverable पर नियम बनाएँ, और अनुपस्थित इंटेलिजेंस को “अज्ञात” मानें, “सुरक्षित” नहीं।

सोशल फुटप्रिंट ऐड-ऑन

enable_social को true पर सेट करने से रिस्पॉन्स में email के अंतर्गत एक email_social ब्लॉक जुड़ जाता है: वे ऑनलाइन प्लेटफ़ॉर्म जिन पर यह ईमेल पता पंजीकृत है, श्रेणी के अनुसार समूहित, सारांश गिनतियों और हमारे डेटा पार्टनरों द्वारा लौटाए गए किसी भी प्रोफ़ाइल विवरण के साथ।

email.email_social.profiles_registered और email.email_social.profiles_checked मुख्य संख्याएँ हैं: वे प्लेटफ़ॉर्म जहाँ ईमेल पता पंजीकृत होने की पुष्टि हुई, जाँचे गए प्लेटफ़ॉर्म की कुल संख्या में से।
email.email_social.registered_platforms और email.email_social.not_registered_platforms हर प्लेटफ़ॉर्म को उसकी category और scope (global, या क्षेत्र-विशिष्ट प्लेटफ़ॉर्म के लिए local) के साथ सूचीबद्ध करते हैं।
email.email_social.categories प्रति श्रेणी पंजीकृत गिनती और अनुपात देता है, और email.email_social.profiles प्रति प्लेटफ़ॉर्म प्रोफ़ाइल विवरण रखता है, जब कोई प्लेटफ़ॉर्म उन्हें उपलब्ध कराता है (नाम, फ़ोटो URL, परिचय पाठ, गोपनीयता स्थिति, व्यावसायिक-खाता फ़्लैग)।
सारांश सूचकांक (digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index) 0-10 के समग्र स्कोर हैं। जब जाँच से किसी गिनती के लिए डेटा नहीं मिलता, तो हर गिनती null हो सकती है।

profiles_registered: 0 एक वास्तविक उत्तर है, विफलता नहीं: प्लेटफ़ॉर्म जाँचे गए थे और ईमेल पता किसी पर भी नहीं मिला, जो सिंथेटिक पहचान का एक आम संकेत है। यह एंडपॉइंट अपने आप इस पर कार्रवाई नहीं करता। इसे समीक्षाधीन या अस्वीकृति निर्णय में बदलने के लिए किसी वर्कफ़्लो में email_no_social_presence_action का उपयोग करें। enable_social सेट न होने पर यह ब्लॉक अनुपस्थित रहता है, और तब भी अनुपस्थित रहता है जब सोशल जाँच पूरी न हो सकी हो। उस स्थिति में उसका शुल्क नहीं लिया जाता।

सैंडबॉक्स व्यवहार

सैंडबॉक्स कुंजियाँ अनुरोध को मान्य करती हैं और निर्धारित, स्वीकृत डेटा लौटाती हैं। वे ईमेल नहीं भेजतीं, क्रेडिट खर्च नहीं करतीं, सत्र नहीं बनातीं, और Networks में योगदान नहीं देतीं। enable_social सेट होने पर वे निर्धारित email_social ब्लॉक भी लौटाती हैं।

बिलिंग

Email Risk API कॉल की सूची कीमत $0.04 है, जो पूर्ण ईमेल सत्यापन से कम है क्योंकि कोई ईमेल नहीं भेजा जाता। लाइव अनुरोध तब बिलने योग्य होता है जब लुकअप शुरू हो जाए, भले ही कुछ सर्वोत्तम-प्रयास फ़ील्ड उपलब्ध न हों। सोशल फुटप्रिंट ऐड-ऑन का शुल्क अलग से लिया जाता है: Email Risk API की कीमत के अलावा प्रति अनुरोध एक email_social यूनिट, जब भी जाँच पूरी होती है। लुकअप से पहले की क्रेडिट जाँच दोनों को कवर करती है।

प्राधिकरण

x-api-key

string

header

आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

बॉडी

application/json

string<email>

आवश्यक

स्कोर करने के लिए ईमेल पता।

उदाहरण:

"alice@example.com"

country_code

string

इंटेलिजेंस कवरेज के लिए वैकल्पिक ISO 3166-1 alpha-2 या alpha-3 देश संकेत।

Maximum string length: 3

उदाहरण:

"US"

signals

object

आपके एप्लिकेशन द्वारा देखा गया वैकल्पिक डिवाइस और नेटवर्क संदर्भ। सभी फ़ील्ड वैकल्पिक हैं। इन्हें पास करने से Networks में क्रॉस-सत्र मिलान डिटेक्शन को सहायता मिलती है।

Show child attributes

vendor_data

string

इस अनुरोध के लिए आपका स्थिर संदर्भ। API सत्र पर संग्रहीत और रिस्पॉन्स में लौटाया गया।

metadata

object | null

आपका गैर-संवेदनशील JSON मेटाडेटा। API सत्र पर संग्रहीत और रिस्पॉन्स में दोहराया गया।

true होने पर, पते के सोशल फ़ुटप्रिंट की भी खोज करें - ईमेल, सोशल, व्यावसायिक, ई-कॉमर्स और मनोरंजन प्लेटफ़ॉर्म जिन पर यह पंजीकृत है। इस endpoint की अपनी कीमत के अतिरिक्त प्रति अनुरोध एक email_social इकाई के रूप में बिल किया जाता है।

उदाहरण:

true

प्रतिक्रिया

जोखिम मूल्यांकन पूरा हो गया। निर्णय के लिए status का निरीक्षण करें; पूर्ण लुकअप के लिए HTTP हमेशा 200 होता है।

request_id

string<uuid>

आवश्यक

इस अनुरोध के लिए बनाए गए API सत्र की Id। यदि आपको बाद के webhook इवेंट या कंसोल गतिविधि के साथ परिणाम को सहसंबंधित करने की आवश्यकता है, तो इसे vendor_data के साथ संग्रहीत करें।

status

enum<string>

आवश्यक

इस API सत्र के लिए अंतिम निर्णय। आमतौर पर Approved; जोखिम मूल्यांकन In Review या Declined उत्पन्न कर सकता है।

उपलब्ध विकल्प:

Approved,

In Review,

Declined

created_at

string<date-time>

आवश्यक

इस रिस्पॉन्स का टाइमस्टैम्प।

vendor_data

string | null

आपके द्वारा भेजे गए vendor_data का इको, जब आपने इसे नहीं भेजा हो तो null।

metadata

object | null

आपके द्वारा भेजे गए metadata का इको, जब आपने इसे नहीं भेजा हो तो null।

object

सामान्यीकृत ईमेल रिपोर्ट, वही ब्लॉक जो ईमेल सत्यापन रिस्पॉन्स द्वारा उपयोग किया जाता है।

Show child attributes

अंतिम संशोधन 7 नवंबर 2026

​रिस्पॉन्स की व्याख्या

​सोशल फुटप्रिंट ऐड-ऑन

​सैंडबॉक्स व्यवहार

​बिलिंग

प्राधिकरण

बॉडी

प्रतिक्रिया

रिस्पॉन्स की व्याख्या

सोशल फुटप्रिंट ऐड-ऑन

सैंडबॉक्स व्यवहार

बिलिंग