Primeros pasos
Integración / SDKs
Verificación de usuarios
Verificación de empresas
Monitorización de transacciones
Registro de cambioscurl -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 de analítica de aplicaciones
Obtén con la API de Didit la analítica de tu aplicación por fechas: sesiones KYC, conversión, embudos y widgets de KYB y transacciones.
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
}
}| Lo que envías | Lo que obtienes |
|---|---|
Ni scope ni widget_keys | El resumen de verificación de usuarios (KYC) del intervalo |
scope, widget_keys o ambos | Los widgets del panel de una pestaña: kyc, kyb, transactions o home (cualquier combinación de los tres) |
kind y un title; el resto de sus campos depende del tipo. Envía scope sin widget_keys una vez para leer available_widget_keys y, después, solicita solo los widgets que necesites.
403 independientemente de los permisos que tenga, y lo mismo ocurre con una clave de otra aplicación. Consulta claves de API.Contenido relacionado
- Obtener las verificaciones de hoy por hora
- Panel de análisis
- Claves de API y acceso con ámbito limitado
Autorizaciones
La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.
Parámetros de ruta
UUID de la organización.
UUID de la aplicación. Debe ser la aplicación a la que pertenece la clave de API: una clave usada en cualquier otra aplicación recibe 403.
Parámetros de consulta
Primer día del rango, YYYY-MM-DD, inclusive (UTC). Envíalo junto con end_date: si falta cualquiera de los dos, se ignoran ambos y el rango va desde 30 días antes de hoy hasta hoy.
"2026-10-01"
Último día del rango, YYYY-MM-DD, inclusive (UTC). Una fecha futura cuenta como hoy. El rango no puede superar los 730 días.
"2026-10-15"
Pestaña del panel cuyos widgets se devuelven (no distingue mayúsculas de minúsculas). Omítela, junto con widget_keys, para obtener el resumen de KYC. Enviar solo widget_keys implica kyc. home acepta cualquier widget de KYC, KYB o transacciones y, por defecto, usa el diseño de inicio guardado de la aplicación.
home, kyc, kyb, transactions Claves de widgets separadas por comas, que se devuelven en este orden. Las claves que el ámbito no acepta se descartan; si no queda ninguna, recibes los valores predeterminados del ámbito. 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. Transacciones: 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"
IDs de flujos separados por comas. Limita el resumen de KYC y los widgets de KYC y KYB a esos flujos. Los valores que no son UUID se ignoran; si ninguno es válido, se descarta el filtro. El resumen también acepta workflow_id.
"33333333-4444-5555-6666-777777777777"
Números de versión de flujo separados por comas. Solo se aplica junto con workflow_ids; los valores que no son números enteros se ignoran. También se acepta version como alias.
"3,4"
IDs de rutas de rama separados por comas. Solo se aplica junto con workflow_ids y solo a las cifras de KYC. Actualmente las cifras solo se registran para default (todas las rutas combinadas), por lo que cualquier otro valor devuelve cifras vacías. Se acepta branch_path_id como alias.
"default"
Solo widgets de transacciones: UUID o nombres de etiquetas separados por comas.
Solo widgets de transacciones: categorías de transacción separadas por comas.
"finance"
Solo widgets de transacciones: tipos de acción separados por comas (sin distinguir mayúsculas de minúsculas).
"withdrawal"
Respuesta
El resumen de KYC, o los widgets solicitados cuando se envía scope o widget_keys.
- Option 1
- Option 2
Resumen de verificación de usuarios (KYC), que se devuelve cuando no se envía ni scope ni widget_keys.
Un punto por día, desde el primer día con sesiones dentro del rango hasta end_date. Siempre diario, independientemente de lo que indique grouping_mode.
Show child attributes
Show child attributes
Totales por estado para el rango. El desglose del período anterior incluye al menos los campos obligatorios.
Show child attributes
Show child attributes
Puntos diarios del período de la misma duración inmediatamente anterior a start_date.
Show child attributes
Show child attributes
Totales por estado para el rango. El desglose del período anterior incluye al menos los campos obligatorios.
Show child attributes
Show child attributes
total_approved / (total_approved + total_declined + total_in_review) x 100, con un decimal. null cuando no ha finalizado nada.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Los cinco primeros de cada uno, ordenados de más a menos sesiones.
Show child attributes
Show child attributes
Indexado por ID de flujo. total son las sesiones iniciadas en ese flujo; steps cuenta las sesiones que llegaron a cada paso (OCR, LIVENESS, FACE_MATCH, AML, POA, PHONE, EMAIL, NFC, DATABASE_VALIDATION, QUESTIONNAIRE, IP_ANALYSIS, AGE_ESTIMATION, KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE). Llegar a un paso no significa superarlo.
Show child attributes
Show child attributes
Tiempo activo que los usuarios dedicaron a verificarse, sin contar los periodos de inactividad. Un objeto vacío cuando no hay datos.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Indexado por función (ID_VERIFICATION, LIVENESS, FACEMATCH, AML, PROOF_OF_ADDRESS, PHONE, EMAIL, NFC, LOCATION, DATABASE_VALIDATION, QUESTIONNAIRE y las funciones KYB). total son las sesiones que llegaron a la función; risks cuenta las sesiones por código y nivel de advertencia.
Show child attributes
Show child attributes
El veredicto automático del flujo, antes de que un revisor lo cambiara.
Show child attributes
Show child attributes
Cómo se agrupan las listas *_time_series: day hasta 14 días, week hasta 90 y month a partir de ahí. Se mide desde el primer día con sesiones en el rango.
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