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"
}

Проверка электронной почты

Email Risk API: проверка доставляемости и утечек

Оцените риск email без отправки OTP. Доставляемость, одноразовые домены, утечки и признаки мошенничества в одном серверном вызове Didit.

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"
}

Используйте POST /v3/email/risk/, когда нужна информация о email, не запрашивая у пользователя ввод одноразового кода. Запрос не отправляет письмо. Он создает API-сессию, обогащает адрес, применяет ваши правила оценки риска и возвращает в одном синхронном ответе тот же нормализованный блок email, что и Проверка электронной почты. Когда запрос сохранен, Didit также может использовать оценку email как агрегированное доказательство в разделе Сети. Графы сетей могут показывать данные о высоком риске email, контекст утечек и покрытие социальных профилей по общим email-сигналам, но они не раскрывают другим организациям исходный адрес email.

Интерпретация ответа

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 это id API-сессии. Сохраните его вместе с vendor_data, если нужно сопоставить результат с последующими webhook-событиями или активностью в консоли.

email.email_intelligence и email.enrichment являются полями «по возможности». Успешно завершенный поиск может не содержать ни одного из них, если для этого адреса, домена или тарифа не вернулись пригодные данные. Сначала стройте правила на основе is_breached, is_disposable и is_undeliverable, а отсутствие данных аналитики трактуйте как «неизвестно», а не как «безопасно».

Дополнение для анализа социального следа

Установите enable_social в true, чтобы добавить в ответ блок email_social внутри email. Он содержит онлайн-платформы, на которых зарегистрирован этот адрес, сгруппированные по категориям, со сводными счетчиками и данными профилей, которые предоставляют наши партнеры по данным.

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 не установлен, а также когда проверку социальных сетей не удалось завершить. В этом случае она не тарифицируется.

Поведение в песочнице

Ключи песочницы проверяют запрос и возвращают детерминированные данные с результатом одобрения. Они не отправляют письмо, не расходуют кредиты, не создают сессию и не участвуют в Сетях. Если задан enable_social, они также возвращают детерминированный блок email_social.

Биллинг

Вызовы Email Risk API стоят $0.04 по прайс-листовой цене, что дешевле полной Проверки электронной почты, поскольку письмо не отправляется. Запрос в рабочей среде тарифицируется, как только начинается поиск, даже если некоторые поля «по возможности» недоступны. Дополнение для анализа социального следа тарифицируется отдельно: одна единица email_social за запрос сверх цены Email Risk API, когда проверка завершена. Проверка баланса кредитов перед поиском покрывает оба списания.

Авторизации

x-api-key

string

header

обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как 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, также запрашивает цифровой след адреса: платформы электронной почты, социальные, профессиональные сети, площадки электронной коммерции и развлекательные сервисы, где он зарегистрирован. Тарифицируется как одна единица email_social за запрос дополнительно к цене самого endpoint.

Пример:

true

Ответ

Оценка риска завершена. Проверьте status для получения решения; для завершённых запросов HTTP-код всегда 200.

request_id

string<uuid>

обязательно

Идентификатор API-сессии, созданной для этого запроса. Сохраняйте его вместе с vendor_data, если нужно сопоставлять результат с последующими событиями webhook или действиями в консоли.

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 г.

​Интерпретация ответа

​Дополнение для анализа социального следа

​Поведение в песочнице

​Биллинг

Авторизации

Тело

Ответ

Интерпретация ответа

Дополнение для анализа социального следа

Поведение в песочнице

Биллинг