Saltar al contenido principal
GET
cURL

Autorizaciones

x-api-key
string
header
requerido

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

settings_uuid
string<uuid>
requerido

UUID por versión del flujo (el valor uuid que devuelve el endpoint de listado). Cada versión de un flujo tiene su propio settings_uuid.

Respuesta

Configuración completa del flujo. La estructura es la serialización sin procesar de VerificationSettings (~190 campos: cada activación de función, umbral, acción de advertencia, configuración de documentos permitidos, el workflow_graph, la política de reintentos, los callbacks y los precios). El ejemplo siguiente está abreviado. Notas: features es una cadena unida con " + " (p. ej., "OCR + LIVENESS"), los precios son números JSON e is_editable es true solo para las versiones draft.

Los campos siguientes están tipados; el objeto también incluye todas las demás columnas de la configuración del flujo (activación de funciones, umbrales, acciones ante advertencias, documentos permitidos, callbacks) como propiedades adicionales. Los campos que no se aplican al workflow_type son null.

uuid
string<uuid>

Identificador por versión (settings_uuid). Cada versión de un flujo tiene el suyo.

workflow_id
string<uuid>

Identificador estable compartido por todas las versiones del flujo. Las sesiones creadas con él usan la última versión publicada.

workflow_label
string

Nombre visible del flujo.

workflow_type
enum<string> | null

Plantilla del flujo. null en los flujos de grafo creados sin plantilla.

Opciones disponibles:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
is_default
boolean

Si este es el flujo predeterminado de la aplicación.

is_archived
boolean

Los flujos archivados no pueden iniciar nuevas sesiones.

version
integer

Número de versión dentro del flujo.

status
enum<string>

Las versiones en borrador son editables; las versiones publicadas son inmutables y se usan para las nuevas sesiones.

Opciones disponibles:
draft,
published
published_at
string<date-time> | null

Cuándo se publicó esta versión. null para los borradores.

is_simple_workflow
boolean

true cuando el flujo no tiene un workflow_graph personalizado.

is_editable
boolean

true solo para las versiones draft.

workflow_url
string<uri>

URL pública que inicia una sesión con este flujo.

workflow_graph
object | null

Estructura de grafo del flujo de verificación (workflow) (nodos y aristas). null para flujos simples.

features
string

Funciones habilitadas unidas con " + ", por ejemplo "OCR + LIVENESS".

total_price
number | null

Precio por sesión; en los flujos de tipo grafo, la ruta más cara.

min_price
number | null

Precio de la ruta más económica del flujo.

max_price
number | null

Precio de la ruta más cara del flujo.

special_add_on_prices
object | null

Precios de complementos específicos de la organización, o null si no hay ninguno configurado.

max_retry_attempts
integer

Reintentos permitidos tras una verificación rechazada.

retry_window_days
integer | null

Días durante los que se permiten los reintentos.

session_expiration_time
integer

Segundos antes de que expire una sesión sin finalizar.

questionnaire
object | null

El cuestionario asociado al flujo, o null.

kyb_role_settings
object[]

Configuración de verificación por rol para las personas clave de KYB.

created_at
string<date-time>
updated_at
string<date-time>
signature_availability
object

Qué niveles de Firma electrónica pueden firmar en este momento. Consúltalo antes de definir signature_level. Se devuelve en los flujos kyc, kyb y de grafo.

is_bank_verification_enabled
boolean

Indica si un flujo de verificación (workflow) simple de KYC o KYB ejecuta la verificación bancaria. Se ejecuta después de los pasos de contacto (y de la verificación de ubicación) y antes de la validación de base de datos, el análisis AML y el análisis de IP. La verificación bancaria aún no está disponible de forma general: se rechaza su activación donde no esté habilitada.

bank_verification_config
object

Configuración de verificación bancaria de un flujo simple, con las mismas claves que admite un nodo BANK_VERIFICATION (por ejemplo, bank_countries y bank_method_order). Las claves desconocidas se descartan. Todas las claves son opcionales y una clave ausente mantiene su valor predeterminado, por lo que {} significa todos los valores predeterminados. Consulta Configuración de verificación bancaria.

Ejemplo:
is_geolocation_enabled
boolean

Indica si un flujo de verificación (workflow) simple de KYC ejecuta la verificación de ubicación. Se ejecuta después de los pasos de contacto y antes de la verificación bancaria y la validación de base de datos. Los flujos de empresas (KYB) no pueden ejecutarla.

geolocation_config
object

Configuración de verificación de ubicación de un flujo simple, con las mismas claves que admite un nodo GEOLOCATION (por ejemplo, is_geolocation_geofencing_enabled y geolocation_max_attempts). Las claves desconocidas se descartan. Todas las claves son opcionales y una clave ausente conserva su valor predeterminado, por lo que {} significa todos los valores predeterminados.

Ejemplo:
Última modificación el 1 de noviembre de 2026