Начало работы
Интеграция / SDK
Проверка пользователей
Верификация бизнеса
Мониторинг транзакций
Журнал измененийcurl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/analytics/?start_date=2026-10-01&end_date=2026-10-15' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.analytics.retrieve()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.analytics.retrieve();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Analytics.Retrieve(ctx, didit.AnalyticsRetrieveParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.analytics().retrieve();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->analytics->retrieve();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.analytics.retrieve
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Analytics.RetrieveAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"grouping_mode": "day",
"data_points": [
{
"rounded_date": "2026-10-14",
"total": 12,
"approved": 8,
"declined": 1,
"canceled": 1,
"pending": 2,
"in_review": 1,
"expired": 1,
"abandoned": 0,
"in_progress": 1,
"not_started": 0,
"manually_approved": 1,
"manually_declined": 0
},
{
"rounded_date": "2026-10-15",
"total": 10,
"approved": 6,
"declined": 2,
"canceled": 0,
"pending": 2,
"in_review": 2,
"expired": 0,
"abandoned": 0,
"in_progress": 0,
"not_started": 0,
"manually_approved": 0,
"manually_declined": 1
}
],
"request_breakdown": {
"total_approved": 14,
"total_in_review": 3,
"total_declined": 3,
"total_canceled": 1,
"total_pending": 4,
"total_expired": 1,
"total_abandoned": 0,
"total_in_progress": 1,
"total_not_started": 0,
"total_manually_approved": 1,
"total_manually_declined": 1
},
"conversion_rate": 70,
"location_stats": {
"countries": [
{
"session_count": 15,
"country": "Spain",
"country_code": "ES"
},
{
"session_count": 7,
"country": "Portugal",
"country_code": "PT"
}
],
"ip_countries": [
{
"session_count": 15,
"country": "Spain",
"country_code": "ES"
},
{
"session_count": 7,
"country": "Portugal",
"country_code": "PT"
}
],
"id_countries": [
{
"country": "Spain",
"country_code": "ES",
"session_count": 14
},
{
"country": "Portugal",
"country_code": "PT",
"session_count": 6
}
],
"conversion_by_country": [
{
"country": "Spain",
"country_code": "ES",
"finished": 13,
"approved": 10
},
{
"country": "Portugal",
"country_code": "PT",
"finished": 6,
"approved": 4
}
],
"cities": [
{
"session_count": 9,
"location": "Madrid, Spain",
"latitude": 40.4168,
"longitude": -3.7038
}
]
},
"demographic_stats": {
"age_distribution": {
"under_18": 0,
"18_24": 5,
"25_34": 8,
"35_44": 4,
"45_64": 2,
"65_plus": 1
},
"gender_distribution": {
"M": 11,
"F": 9
}
},
"device_details": {
"device_models": [
{
"device": "Apple",
"count": 12
},
{
"device": "Android",
"count": 10
}
],
"browsers": [
{
"browser": "Safari",
"count": 12
},
{
"browser": "Chrome",
"count": 10
}
],
"operating_systems": [
{
"os": "iOS",
"count": 12
},
{
"os": "Android",
"count": 10
}
]
},
"workflow_funnel_stats": {
"33333333-4444-5555-6666-777777777777": {
"total": 22,
"steps": {
"OCR": {
"reached": 21
},
"LIVENESS": {
"reached": 19
},
"FACE_MATCH": {
"reached": 19
},
"AML": {
"reached": 18
}
}
}
},
"verification_time_stats": {
"overall_avg_seconds": 64,
"overall_count": 18,
"per_feature": {
"OCR": {
"avg_seconds": 41.2,
"total_seconds": 741.6,
"count": 18
},
"LIVENESS": {
"avg_seconds": 22.8,
"total_seconds": 410.4,
"count": 18
}
},
"per_sub_step": {
"OCR": {
"front_id_photo": {
"avg_seconds": 18.3,
"total_seconds": 329.4,
"count": 18
}
}
}
},
"resubmission_stats": {
"first_pass": 17,
"second": 2,
"third_plus": 1,
"abandoned": 0
},
"warning_stats": {
"ID_VERIFICATION": {
"total": 21,
"risks": {
"DOCUMENT_EXPIRED": {
"error": 1,
"warning": 0,
"information": 0
}
}
},
"LIVENESS": {
"total": 19,
"risks": {
"LOW_LIVENESS_SCORE": {
"error": 0,
"warning": 2,
"information": 0
}
}
}
},
"original_status_stats": {
"approved": 13,
"in_review": 5,
"declined": 2
},
"demographic_time_series": [
{
"date": "2026-10-14",
"age_distribution": {
"under_18": 0,
"18_24": 3,
"25_34": 4,
"35_44": 2,
"45_64": 1,
"65_plus": 0
},
"gender_distribution": {
"M": 6,
"F": 4
}
},
{
"date": "2026-10-15",
"age_distribution": {
"under_18": 0,
"18_24": 2,
"25_34": 4,
"35_44": 2,
"45_64": 1,
"65_plus": 1
},
"gender_distribution": {
"M": 5,
"F": 5
}
}
],
"device_time_series": [
{
"date": "2026-10-14",
"devices": {
"Apple": 7,
"Android": 5
},
"browsers": {
"Safari": 7,
"Chrome": 5
},
"operating_systems": {
"iOS": 7,
"Android": 5
}
},
{
"date": "2026-10-15",
"devices": {
"Apple": 5,
"Android": 5
},
"browsers": {
"Safari": 5,
"Chrome": 5
},
"operating_systems": {
"iOS": 5,
"Android": 5
}
}
],
"verification_time_time_series": [
{
"date": "2026-10-14",
"overall_avg": 66.1,
"per_feature": {
"OCR": 42,
"LIVENESS": 24.1
}
},
{
"date": "2026-10-15",
"overall_avg": 61.5,
"per_feature": {
"OCR": 40.2,
"LIVENESS": 21.3
}
}
],
"resubmission_time_series": [
{
"date": "2026-10-14",
"first_pass": 9,
"second": 1,
"third_plus": 0,
"abandoned": 0
},
{
"date": "2026-10-15",
"first_pass": 8,
"second": 1,
"third_plus": 1,
"abandoned": 0
}
],
"original_status_time_series": [
{
"date": "2026-10-14",
"approved": 7,
"in_review": 3,
"declined": 1
},
{
"date": "2026-10-15",
"approved": 6,
"in_review": 2,
"declined": 1
}
],
"previous_data_points": [
{
"rounded_date": "2026-10-12",
"total": 9,
"approved": 6,
"declined": 1,
"canceled": 1,
"pending": 1
},
{
"rounded_date": "2026-10-13",
"total": 11,
"approved": 7,
"declined": 2,
"canceled": 0,
"pending": 2
}
],
"previous_request_breakdown": {
"total_approved": 13,
"total_in_review": 2,
"total_declined": 3,
"total_canceled": 1,
"total_pending": 3
}
}API аналитики верификации приложения
Получайте аналитику верификации приложения Didit за период: итоги KYC-сессий, конверсию, воронки и виджеты дашборда KYB и транзакций.
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/analytics/?start_date=2026-10-01&end_date=2026-10-15' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.analytics.retrieve()
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.analytics.retrieve();
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Analytics.Retrieve(ctx, didit.AnalyticsRetrieveParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.analytics().retrieve();
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->analytics->retrieve();
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.analytics.retrieve
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Analytics.RetrieveAsync();
Console.WriteLine(JsonSerializer.Serialize(result));{
"grouping_mode": "day",
"data_points": [
{
"rounded_date": "2026-10-14",
"total": 12,
"approved": 8,
"declined": 1,
"canceled": 1,
"pending": 2,
"in_review": 1,
"expired": 1,
"abandoned": 0,
"in_progress": 1,
"not_started": 0,
"manually_approved": 1,
"manually_declined": 0
},
{
"rounded_date": "2026-10-15",
"total": 10,
"approved": 6,
"declined": 2,
"canceled": 0,
"pending": 2,
"in_review": 2,
"expired": 0,
"abandoned": 0,
"in_progress": 0,
"not_started": 0,
"manually_approved": 0,
"manually_declined": 1
}
],
"request_breakdown": {
"total_approved": 14,
"total_in_review": 3,
"total_declined": 3,
"total_canceled": 1,
"total_pending": 4,
"total_expired": 1,
"total_abandoned": 0,
"total_in_progress": 1,
"total_not_started": 0,
"total_manually_approved": 1,
"total_manually_declined": 1
},
"conversion_rate": 70,
"location_stats": {
"countries": [
{
"session_count": 15,
"country": "Spain",
"country_code": "ES"
},
{
"session_count": 7,
"country": "Portugal",
"country_code": "PT"
}
],
"ip_countries": [
{
"session_count": 15,
"country": "Spain",
"country_code": "ES"
},
{
"session_count": 7,
"country": "Portugal",
"country_code": "PT"
}
],
"id_countries": [
{
"country": "Spain",
"country_code": "ES",
"session_count": 14
},
{
"country": "Portugal",
"country_code": "PT",
"session_count": 6
}
],
"conversion_by_country": [
{
"country": "Spain",
"country_code": "ES",
"finished": 13,
"approved": 10
},
{
"country": "Portugal",
"country_code": "PT",
"finished": 6,
"approved": 4
}
],
"cities": [
{
"session_count": 9,
"location": "Madrid, Spain",
"latitude": 40.4168,
"longitude": -3.7038
}
]
},
"demographic_stats": {
"age_distribution": {
"under_18": 0,
"18_24": 5,
"25_34": 8,
"35_44": 4,
"45_64": 2,
"65_plus": 1
},
"gender_distribution": {
"M": 11,
"F": 9
}
},
"device_details": {
"device_models": [
{
"device": "Apple",
"count": 12
},
{
"device": "Android",
"count": 10
}
],
"browsers": [
{
"browser": "Safari",
"count": 12
},
{
"browser": "Chrome",
"count": 10
}
],
"operating_systems": [
{
"os": "iOS",
"count": 12
},
{
"os": "Android",
"count": 10
}
]
},
"workflow_funnel_stats": {
"33333333-4444-5555-6666-777777777777": {
"total": 22,
"steps": {
"OCR": {
"reached": 21
},
"LIVENESS": {
"reached": 19
},
"FACE_MATCH": {
"reached": 19
},
"AML": {
"reached": 18
}
}
}
},
"verification_time_stats": {
"overall_avg_seconds": 64,
"overall_count": 18,
"per_feature": {
"OCR": {
"avg_seconds": 41.2,
"total_seconds": 741.6,
"count": 18
},
"LIVENESS": {
"avg_seconds": 22.8,
"total_seconds": 410.4,
"count": 18
}
},
"per_sub_step": {
"OCR": {
"front_id_photo": {
"avg_seconds": 18.3,
"total_seconds": 329.4,
"count": 18
}
}
}
},
"resubmission_stats": {
"first_pass": 17,
"second": 2,
"third_plus": 1,
"abandoned": 0
},
"warning_stats": {
"ID_VERIFICATION": {
"total": 21,
"risks": {
"DOCUMENT_EXPIRED": {
"error": 1,
"warning": 0,
"information": 0
}
}
},
"LIVENESS": {
"total": 19,
"risks": {
"LOW_LIVENESS_SCORE": {
"error": 0,
"warning": 2,
"information": 0
}
}
}
},
"original_status_stats": {
"approved": 13,
"in_review": 5,
"declined": 2
},
"demographic_time_series": [
{
"date": "2026-10-14",
"age_distribution": {
"under_18": 0,
"18_24": 3,
"25_34": 4,
"35_44": 2,
"45_64": 1,
"65_plus": 0
},
"gender_distribution": {
"M": 6,
"F": 4
}
},
{
"date": "2026-10-15",
"age_distribution": {
"under_18": 0,
"18_24": 2,
"25_34": 4,
"35_44": 2,
"45_64": 1,
"65_plus": 1
},
"gender_distribution": {
"M": 5,
"F": 5
}
}
],
"device_time_series": [
{
"date": "2026-10-14",
"devices": {
"Apple": 7,
"Android": 5
},
"browsers": {
"Safari": 7,
"Chrome": 5
},
"operating_systems": {
"iOS": 7,
"Android": 5
}
},
{
"date": "2026-10-15",
"devices": {
"Apple": 5,
"Android": 5
},
"browsers": {
"Safari": 5,
"Chrome": 5
},
"operating_systems": {
"iOS": 5,
"Android": 5
}
}
],
"verification_time_time_series": [
{
"date": "2026-10-14",
"overall_avg": 66.1,
"per_feature": {
"OCR": 42,
"LIVENESS": 24.1
}
},
{
"date": "2026-10-15",
"overall_avg": 61.5,
"per_feature": {
"OCR": 40.2,
"LIVENESS": 21.3
}
}
],
"resubmission_time_series": [
{
"date": "2026-10-14",
"first_pass": 9,
"second": 1,
"third_plus": 0,
"abandoned": 0
},
{
"date": "2026-10-15",
"first_pass": 8,
"second": 1,
"third_plus": 1,
"abandoned": 0
}
],
"original_status_time_series": [
{
"date": "2026-10-14",
"approved": 7,
"in_review": 3,
"declined": 1
},
{
"date": "2026-10-15",
"approved": 6,
"in_review": 2,
"declined": 1
}
],
"previous_data_points": [
{
"rounded_date": "2026-10-12",
"total": 9,
"approved": 6,
"declined": 1,
"canceled": 1,
"pending": 1
},
{
"rounded_date": "2026-10-13",
"total": 11,
"approved": 7,
"declined": 2,
"canceled": 0,
"pending": 2
}
],
"previous_request_breakdown": {
"total_approved": 13,
"total_in_review": 2,
"total_declined": 3,
"total_canceled": 1,
"total_pending": 3
}
}| Что вы отправляете | Что вы получаете |
|---|---|
Ни scope, ни widget_keys | Сводка по проверке пользователей (KYC) за указанный период |
scope, widget_keys или оба параметра | Виджеты панели для одной вкладки: kyc, kyb, transactions или home (любая комбинация из трёх) |
kind и title, остальные поля зависят от типа. Один раз отправьте scope без widget_keys, чтобы получить available_widget_keys, а затем запрашивайте только нужные виджеты.
403 независимо от своих прав, так же как и ключ другого приложения. См. API-ключи.Связанные материалы
Авторизации
API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.
Параметры пути
UUID организации.
UUID приложения. Должно быть приложением, к которому относится API-ключ: при использовании ключа для любого другого приложения возвращается 403.
Параметры запроса
Первый день диапазона, YYYY-MM-DD, включительно (UTC). Передавайте вместе с end_date: если один из параметров отсутствует, оба игнорируются, и диапазон охватывает период от 30 дней назад до сегодняшнего дня.
"2026-10-01"
Последний день диапазона, YYYY-MM-DD, включительно (UTC). Будущая дата считается сегодняшним днём. Диапазон не может превышать 730 дней.
"2026-10-15"
Вкладка панели управления, для которой нужно вернуть виджеты (без учёта регистра). Опустите её вместе с widget_keys для получения сводки по KYC. Передача только widget_keys подразумевает kyc. home принимает любые виджеты KYC, KYB или транзакций и по умолчанию использует сохранённую раскладку главной страницы приложения.
home, kyc, kyb, transactions Разделённые запятыми ключи виджетов, возвращаемые в указанном порядке. Ключи, не поддерживаемые областью действия (scope), отбрасываются; если не останется ни одного, возвращаются значения по умолчанию для этой области. KYC: kyc_sessions_volume, kyc_warning_insights, kyc_id_locations, kyc_ip_locations, kyc_workflow_funnel, kyc_average_verification_time, kyc_conversion_rate, kyc_conversion_by_country, kyc_resubmission_insights, kyc_original_status_distribution, kyc_database_validation_coverage, kyc_database_validation_latency, kyc_demographics, kyc_device_details. KYB: kyb_sessions_volume, kyb_workflow_funnel, kyb_average_verification_time, kyb_ip_locations, kyb_business_country_distribution, kyb_warning_insights, kyb_conversion_rate, kyb_conversion_by_country, kyb_industry_breakdown, kyb_resubmission_insights, kyb_original_status_distribution, kyb_registry_coverage, kyb_registry_data_completeness, kyb_device_details. Транзакции: tx_count_total, tx_count_daily, tx_volume_total_preferred_currency, tx_volume_daily_preferred_currency, tx_average_amount, tx_average_amount_daily, tx_transaction_category_breakdown, tx_action_type_breakdown, tx_status_volume_trend, tx_user_ip_or_country_distribution, tx_tag_breakdown, tx_top_rules_triggered, tx_team_member_performance, tx_score_histogram.
"tx_count_total,tx_count_daily"
Разделённые запятыми идентификаторы сценариев. Ограничивает сводку KYC и виджеты KYC и KYB указанными сценариями. Значения, не являющиеся UUID, игнорируются; если нет ни одного валидного значения, фильтр отбрасывается. Сводка также принимает workflow_id.
"33333333-4444-5555-6666-777777777777"
Разделённые запятыми номера версий сценария. Применяется только вместе с workflow_ids; значения, не являющиеся целыми числами, игнорируются. version принимается в качестве псевдонима.
"3,4"
Разделённые запятыми ID путей ветвей. Применяется только вместе с workflow_ids и только к показателям KYC. В настоящее время показатели фиксируются только для default (все пути вместе), поэтому любое другое значение возвращает пустые показатели. branch_path_id принимается в качестве псевдонима.
"default"
Только для виджетов транзакций: UUID тегов или названия тегов через запятую.
Только для виджетов транзакций: категории транзакций через запятую.
"finance"
Только для виджетов транзакций: типы действий через запятую (без учёта регистра).
"withdrawal"
Ответ
Сводка KYC или запрошенные виджеты, если переданы scope или widget_keys.
- Option 1
- Option 2
Сводка проверки пользователей (KYC), возвращаемая, если не переданы ни scope, ни widget_keys.
Одна точка на день, начиная с первого дня с сессиями в указанном диапазоне и до end_date. Всегда с ежедневной детализацией независимо от значения grouping_mode.
Show child attributes
Show child attributes
Итоговые данные по статусам за диапазон. Разбивка за предыдущий период содержит как минимум обязательные поля.
Show child attributes
Show child attributes
Ежедневные точки за период такой же длительности непосредственно перед start_date.
Show child attributes
Show child attributes
Итоговые данные по статусам за диапазон. Разбивка за предыдущий период содержит как минимум обязательные поля.
Show child attributes
Show child attributes
total_approved / (total_approved + total_declined + total_in_review) x 100, один знак после запятой. null, когда ничего не завершилось.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Топ-5 по каждой категории, сначала с наибольшим количеством сессий.
Show child attributes
Show child attributes
С ключами по ID сценария. total показывает сессии, запущенные по этому сценарию; steps подсчитывает сессии, дошедшие до каждого шага (OCR, LIVENESS, FACE_MATCH, AML, POA, PHONE, EMAIL, NFC, DATABASE_VALIDATION, QUESTIONNAIRE, IP_ANALYSIS, AGE_ESTIMATION, KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE). Дойти до шага не означает пройти его.
Show child attributes
Show child attributes
Активное время, затраченное пользователями на верификацию, без учёта пауз бездействия. Пустой объект, если данных нет.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
С ключами по функциям (ID_VERIFICATION, LIVENESS, FACEMATCH, AML, PROOF_OF_ADDRESS, PHONE, EMAIL, NFC, LOCATION, DATABASE_VALIDATION, QUESTIONNAIRE и функции KYB). Значение total содержит сессии, дошедшие до функции; risks подсчитывает сессии по коду и уровню предупреждения.
Show child attributes
Show child attributes
Автоматическое решение сценария до того, как проверяющий изменил его.
Show child attributes
Show child attributes
Способ группировки списков *_time_series: day для периодов до 14 дней, week до 90 дней, month свыше 90 дней. Отсчитывается от первого дня с сессиями в диапазоне.
day, week, month Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes