Saltar al contenido principal
GET
curl

Visión general

Devuelve una eliminación masiva de sesiones iniciada con Eliminar sesiones en lote: su estado, cuántas sesiones ha procesado y cuántas terminaron en cada resultado. Cuando más de 20 sesiones KYC coinciden con una eliminación en lote, seleccionadas con session_numbers o con delete_all, la solicitud devuelve 202 con un trabajo PENDING y las sesiones se eliminan en segundo plano. Consulta este endpoint cada pocos segundos hasta que status sea COMPLETED o FAILED. El trabajo elimina cada sesión exactamente igual que mediante Eliminar sesión: se eliminan la sesión, todos los intentos de verificación que contiene y todos sus archivos almacenados, y sus URL de medios dejan de funcionar. La eliminación es permanente e irreversible. El trabajo solo informa recuentos. Nunca enumera qué sesiones eliminó.

Estado del trabajo

Un trabajo delete_all elimina solo las sesiones creadas antes de la solicitud. Las sesiones iniciadas mientras se ejecuta no se eliminan.

Recuentos de resultados

deleted_child_verifications cuenta las verificaciones creadas por las verificaciones de empresa eliminadas y eliminadas junto con ellas. Siempre es 0 en un trabajo iniciado con Eliminar sesiones en lote, que solo elimina sesiones KYC.

Permisos

Cualquier clave de API activa de la aplicación puede invocar este endpoint. Un trabajo solo es visible para la aplicación que lo creó; cualquier otro job_id devuelve 404.

Contenido relacionado

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

job_id
string<uuid>
requerido

El job_id devuelto con el 202 de POST /v3/sessions/delete/.

Respuesta

El trabajo.

Una eliminación masiva de sesiones que se ejecuta en segundo plano: progreso y recuentos por resultado, nunca qué sesiones eliminó.

job_id
string<uuid>

Consulta periódicamente GET /v3/sessions/delete/{job_id}/ con este id.

status
enum<string>

PENDING: aceptado, aún no ha comenzado. PROCESSING: eliminando; processed y outcomes se están actualizando. COMPLETED: se han contabilizado todas las sesiones seleccionadas. FAILED: el trabajo se detuvo antes de tiempo; consulta error.

Opciones disponibles:
PENDING,
PROCESSING,
COMPLETED,
FAILED
total
integer

Sesiones seleccionadas cuando se solicitó la eliminación.

processed
integer

Sesiones que el trabajo ha terminado de procesar hasta el momento.

outcomes
object

Cuántas sesiones terminaron con cada resultado. Todas las claves están siempre presentes.

deleted_child_verifications
integer

Verificaciones creadas por las verificaciones de empresas eliminadas, que se eliminaron junto con ellas. Siempre es 0 en un trabajo iniciado con POST /v3/sessions/delete/, que solo elimina sesiones KYC.

error
string | null

null salvo que status sea FAILED; en ese caso, el motivo por el que se detuvo la eliminación. Las sesiones a las que el trabajo no había llegado siguen existiendo: repite la solicitud para eliminarlas.

created_at
string<date-time>

Cuándo se solicitó la eliminación.

completed_at
string<date-time> | null

Fecha y hora en que terminó el trabajo; null mientras se ejecuta.

Última modificación el 1 de noviembre de 2026