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

application/json
locale
string

Configuración regional usada para traducir la respuesta del paso al que avanza la sesión.

Maximum string length: 10

Respuesta

Partes declaradas (o ya declaradas).

valid
boolean
next_step
string | null

Paso en el que se encuentra la sesión.

status
string

Estado de la sesión de empresa.

advanced
boolean

true cuando esta llamada declaró las partes e hizo avanzar la sesión.

already_submitted
boolean

true cuando las partes ya se habían declarado en una llamada anterior.

kyb_key_people_status
string
parties
object[]
Última modificación el 1 de noviembre de 2026