Solicitar la eliminación de una sesión de verificación

El endpoint te permite solicitar que se elimine la información de una de tus sesiones de verificación. Úsalo, por ejemplo, cuando la persona que se verificó te pide que se borren sus datos.

Lee primero la introducción a la eliminación de datos para conocer cómo se procesa la solicitud.

Aplica a cualquier sesión de verificación: las de la V2, las de la V3 y las de pasaporte.

Qué se elimina

Al concluir la solicitud se eliminan los archivos de la sesión (imágenes y documentos) y sus webhooks. La sesión deja de estar disponible: ya no aparece en el listado y, si la consultas, la respuesta es un error 404.

Método: POST

Endpoint

https://api.verificamex.com/identity/v1/data-deletion-requests/verification-session

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Encabezado	Valor	Descripción
Accept	`application/json`	Tipo de contenido de la respuesta.
Content-Type	`application/json`	Tipo de contenido de la solicitud.
Authorization	`Bearer {tu_token}`	Token generado para autenticar al usuario.

Cuerpo de la Solicitud

Parámetro	Tipo	Descripción
verification_session_id	`String`	ID (UUID) de la sesión de verificación que quieres eliminar.
reporter_email	`String`	Correo al que avisaremos cuando recibamos la solicitud y cuando concluya. Puedes indicar varios separados por coma (máximo 500 caracteres en total).
notes	`String` Opcional	Comentario libre, por ejemplo el motivo de la solicitud (máximo 1000 caracteres).

Ejemplo de cuerpo de la solicitud

JSON

    {
        "verification_session_id": "a2f13802-febb-445b-80db-069f46b1e292",
        "reporter_email": "privacidad@empresa.com, legal@empresa.com",
        "notes": "El titular pidió borrar sus datos."
    }

Respuesta del Endpoint

    {
        "data": {
            "object": "DataDeletionRequest",
            "id": "a2f13803-0275-4ac3-99ff-719fa6e16538",
            "source": "VERIFICATION_SESSION",
            "status": "PENDING",
            "user_id": 1024,
            "verification_session_id": "a2f13802-febb-445b-80db-069f46b1e292",
            "reporter_email": "privacidad@empresa.com, legal@empresa.com",
            "reporter_ip": "201.141.22.10",
            "notes": "El titular pidió borrar sus datos.",
            "admin_notes": null,
            "requested_at": "2026-10-09T12:05:05-06:00",
            "completed_at": null,
            "completed_by_user_id": null,
            "created_at": "2026-10-09T12:05:05-06:00",
            "updated_at": "2026-10-09T12:05:05-06:00"
        },
        "meta": {
            "include": [
                "user",
                "verificationSession"
            ],
            "custom": []
        }
    }

    {
        "message": "La sesión de verificación no existe.",
        "errors": []
    }

    {
        "message": "El campo verification session id es obligatorio. (and 1 more error)",
        "errors": {
            "verification_session_id": [
                "El campo verification session id es obligatorio."
            ],
            "reporter_email": [
                "El campo reporter email es obligatorio."
            ]
        }
    }

    {
        "message": "Unauthorized"
    }

Consulta el significado de cada campo en Consultar una solicitud de eliminación.