Saltar al contenido principal
POST
Python

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

sessionId
string<uuid>
requerido

UUID de la sesión de Verificación de empresas (KYB). Debe pertenecer a la aplicación de la clave de API.

Ejemplo:

"33333333-4444-5555-6666-777777777777"

Parámetros de consulta

node_id
string

Nodo del flujo correspondiente al paso KYB. Solo es necesario cuando el flujo tiene más de un nodo KYB; de forma predeterminada, Didit usa el propio nodo de la sesión.

Cuerpo

multipart/form-data
documents
file[]
requerido

Archivos que se van a subir: JPG, JPEG, PNG, TIFF, WEBP, PDF o archivos ZIP que los contengan. PDF de hasta 50 MB y fotos de hasta 6 MB antes de la compresión.

document_passwords
string[]

Una entrada por archivo en documents, en el mismo orden: la contraseña de un PDF protegido, vacía para cualquier otro archivo.

document_group
enum<string>

Grupo de documentos requerido al que responde esta carga.

Opciones disponibles:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Configuración regional usada para traducir la respuesta del siguiente paso.

Maximum string length: 10

Respuesta

Documentos procesados. Cuando se cumplen todos los grupos obligatorios, la sesión avanza y next_step indica el siguiente paso; de lo contrario, permanece en el paso Documentos y document_groups y document_answer indican lo que aún falta.

valid
boolean
next_step
string | null

Paso en el que se encuentra la sesión tras la subida.

kyb_status
string

Estado de la comprobación de la empresa.

document_answer
object

Resultado por cada documento subido y las subidas restantes.

Última modificación el 1 de noviembre de 2026