# Mostrar sesión de verificación (V3) Fuente: /identity-verification-v3/show-verification-session/ 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](/authentication/generate-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** ```json { "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< **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](/identity-verification-v3/biometric-thresholds/). | | `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](/identity-verification-v3/qr-validation/). | | `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](/identity-verification-v3/user-location/). | | `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](/identity-verification-v3/political-affiliation/). | | 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`.