Mostrar sesión de verificación (V3)

Este endpoint te permite obtener el detalle de una sesión de verificación V3 a partir del uuid que devolvió el endpoint de creación, incluyendo el resultado y los archivos generados durante el proceso.

La consulta se hace sobre la ruta V2

La versión 3 sólo tiene endpoint de creación. Para consultar una sesión creada con V3 se utiliza la ruta de la V2, que detecta automáticamente con qué versión se creó la sesión y ajusta la respuesta en consecuencia. Fíjate en el /v2/ de la URL.

Método: GET

Endpoint

https://api.verificamex.com/identity/v2/identity/sessions/{uuid}

Nota

Recuerda que debes tener un token válido para realizar la solicitud. Puedes obtener un token siguiendo los pasos descritos en la sección Generar tokens.

Encabezados de la Solicitud

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

Parámetros de la Solicitud

Parámetro	Tipo	Descripción
uuid	String	Identificador de la sesión, devuelto al crearla.

Query Parameters

Parámetro	Tipo	Descripción
include	String	Información adicional de objetos relacionados. Valores permitidos: "ine", "renapo", "files".
with_binaries	Boolean	Incluye el contenido de cada archivo en Base64. En sesiones V3 el valor por defecto es false.

Respuesta del Endpoint

status 200

    {
        "data": {
            "object": "VerificationSession",
            "id": "870c7eee-3604-4995-aa98-bc8fa6aa1112",
            "status": "FINISHED",
            "result": 100,
            "errors": null,
            "comments": null,
            "only_mobile_devices": true,
            "redirect_url": "https://tusitio.com/finalizado",
            "webhook": "https://tu-api.com/webhooks/verificamex",
            "validations": [
                "INE",
                "CURP"
            ],
            "document_data": {
                "cic": "123456789012",
                "curp": "PEPJ820131HDFRRN09",
                "id_ciudadano": "012345678"
            },
            "ocr": {
                "ocr_frontal": {
                    "num_emisiones": "00",
                    "anio_registro": "2022",
                    "clave_elector": "PEPJ820131H400",
                    "curp": "PEPJ820131HDFRRN09",
                    "domicilio": "CALLE FALSA 123\nCOL CENTRO\nCDMX",
                    "address": {
                        "ln1": "CALLE FALSA 123",
                        "ln2": "COL CENTRO",
                        "ln3": "CDMX"
                    },
                    "demarcacion": "CDMX",
                    "fecha_nacimiento": "31/01/1982",
                    "nombre_completo": "PEREZ\nJUAREZ\nPEPE",
                    "primer_apellido": "PEREZ",
                    "seccion": "1234",
                    "segundo_apellido": "JUAREZ",
                    "sexo": "H",
                    "vigencia": "2030",
                    "codigo_postal": "06000",
                    "nombres": "PEPE",
                    "anio_emision": "2022",
                    "version_frontal": "GH"
                },
                "ocr_reverso": {
                    "mrz": "IDMEXPEPJ820131<<<<<<<<<<<<<<<\n8201314H3001019MEX<<<<<<<<<<<0\nPEREZ<<JUAREZ<<PEPE<<<<<<<<<<<"
                }
            },
            "verifications": {
                "fecha_nacimiento_match": true,
                "sexo_match": true,
                "seccion_match": true
            },
            "coincidence": 95.5,
            "thresholds": {
                "liveness": 80,
                "face_match": 90,
                "qr_face_match": 80
            },
            "qr_validation": null,
            "user_location": null,
            "political_affiliation": null,
            "optionals": {
                "id_cliente": "A-10293"
            },
            "form_url": "https://app.verificamex.com/verification/870c7eee-3604-4995-aa98-bc8fa6aa1112",
            "created_at": "2026-07-21T22:40:55.000000Z",
            "updated_at": "2026-07-21T22:48:03.000000Z",
            "readable_created_at": "hace 8 minutos",
            "readable_updated_at": "hace 1 minuto",
            "files": [
                {
                    "object": "VerificationFiles",
                    "id": "9d8058ab",
                    "file_type": "ID_FRONT",
                    "mime_type": "image/jpeg",
                    "size": 284736,
                    "url": "https://storage.googleapis.com/...&X-Goog-Signature=...",
                    "created_at": "2026-07-21T22:47:00.000000Z",
                    "updated_at": "2026-07-21T22:47:00.000000Z"
                }
            ]
        },
        "meta": {
            "include": [
                "ine",
                "renapo"
            ],
            "custom": []
        }
    }

status 401

    {
        "message": "Unauthorized"
    }

La respuesta del detalle sí viene envuelta

A diferencia del endpoint de creación, que devuelve un objeto plano, aquí los datos vienen dentro de data y el identificador se llama id, no uuid.

El cuerpo de la respuesta contiene los siguientes parámetros:

Parámetro	Tipo	Descripción
id	String	Identificador de la sesión. Equivale al uuid que devolvió la creación.
status	String	Estado de la sesión: OPEN, VERIFYING, FINISHED o FAILED.
result	Integer	Puntaje del resultado de la verificación. null mientras no concluya.
errors	Array	Incidencias detectadas durante la verificación. null si no hubo.
comments	String	Descripción legible de la última incidencia.
only_mobile_devices	Boolean	Si la sesión estaba restringida a dispositivos móviles.
redirect_url	String	URL de redirección configurada al crear la sesión.
webhook	String	URL de notificación configurada al crear la sesión.
validations	Array	Validaciones solicitadas para esta sesión.
document_data	Object	Identificadores extraídos de la credencial: cic, curp e id_ciudadano (número de identificación ciudadana del MRZ). null en cada campo mientras la sesión no termine.
ocr	Object	Texto leído por OCR, separado en ocr_frontal y ocr_reverso (por ahora solo mrz). Ambos vienen como {} mientras la sesión no termine. ocr_frontal no tiene un shape fijo: incluye todos los campos que el OCR haya extraído del anverso (nombre, CURP, domicilio —como texto y como objeto address: {ln1, ln2, ln3}—, fecha de nacimiento, sección, vigencia, etc.), y puede variar según el modelo de credencial detectado.
verifications	Object	Validaciones cruzadas del MRZ contra los datos del documento (fecha de nacimiento, sexo, sección). Objeto vacío mientras la sesión no termine.
coincidence	Number	Porcentaje de coincidencia facial entre la foto de la credencial y la selfie (0–100). Llega en 0 cuando no alcanzó thresholds.face_match: la similitud por debajo del umbral no se informa. null mientras la sesión no termine.
thresholds	Object	Umbrales (%) con los que se calificó la sesión: face_match (comparación facial), liveness (prueba de vida) y qr_face_match (fotografía del QR). Incluyen los valores por defecto cuando no enviaste los tuyos. liveness y qr_face_match solo vienen en null en sesiones creadas antes de que existiera esta opción. Ver Umbrales de biometría.
qr_validation	Object	Resultado de la lectura y cotejo del QR del reverso. null si la sesión no se creó con qr_validation: true. Ver Validación de QR.
user_location	Object	Ubicación del dispositivo (coordenadas, precisión, dirección aproximada). null si la sesión no se creó con capture_user_location: true o si no se obtuvo. Ver Ubicación del usuario.
political_affiliation	Object	Estado y resultado de la consulta de afiliación a partidos políticos. null si la sesión no se creó con political_affiliation: true. Ver Afiliación a partidos políticos.
optionals	Object	Los datos opcionales que enviaste al crear la sesión.
files	Array	Documentos generados durante el proceso. Ver la sección siguiente.
ine	Object	Resultado de la validación ante Lista Nominal (con ?include=ine).
renapo	Object	Resultado de la validación ante RENAPO (con ?include=renapo).

Diferencia con la V2

En la V2 estos mismos datos se entregan como data.ine_reading.DocumentData, un arreglo de objetos {Type, Source, Value}. La V3 los aplana en document_data, ocr, verifications y coincidence para que no tengas que mapear Type/Source a cada campo.

---

Archivos de la verificación

El arreglo files[] contiene los documentos generados durante el proceso: el PDF con el resumen de la verificación, las fotografías del anverso y reverso de la identificación, el PDF de CURP (RENAPO) y el PDF de la Lista Nominal del INE, entre otros.

En las sesiones V3 cada archivo se entrega únicamente como URL firmada en el campo url, sin el contenido en Base64.

La URL firmada expira a los 15 minutos

Descarga los archivos en cuanto recibas la respuesta en lugar de almacenar la URL. Si expira, vuelve a consultar este endpoint para obtener enlaces nuevos.

¿Necesitas el archivo en Base64?

Agrega ?with_binaries=true y cada elemento de files[] incluirá también el campo binary con el contenido codificado. Ten en cuenta que la respuesta puede superar los 10 MB cuando la sesión tiene varias evidencias.

Diferencia con la V2

En las sesiones creadas con la V2, el campo binary sí se incluye por defecto. Puedes omitirlo con ?with_binaries=false.