# Mostrar detalles de sesión de verificación

Fuente: /identity-verification/show-verification-session/

El endpoint te permite **obtener los detalles de una sesión de verificación** en específico filtrando por el `id` de la sesión de verificación.

**Método:**   GET

#### **Endpoint**

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

> **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**

Para realizar la solicitud es necesario incluir los siguientes encabezados:

| 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 |
| - | - | - |
| id | `String` | ID de la sesión de verificación. |

#### **Query Parameters**

| Parámetro | Tipo | Descripción |
| - | - | - |
| include | `String` | Incluir información adicional de objetos relacionados. Valor por defecto: `ine`,`renapo`,`files`. |
| `with_binaries` | `Boolean` | Controla si cada archivo incluye además su contenido en Base64, en el campo `binary`. Por defecto `true`. |

### **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.

Cada archivo se entrega con una **URL firmada** en el campo `url` y, por defecto, también con su
contenido en Base64 en el campo `binary`.

> **Sesiones creadas con la V3**
>
> Si consultas una sesión creada con la [versión 3](/identity-verification-v3/create-verification-session/),
> el campo `binary` **no** se incluye por defecto. Consulta
> [Mostrar sesión de verificación (V3)](/identity-verification-v3/show-verification-session/).

Estructura de cada elemento de `files[]`:

```json
"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": "2024-01-02T15:29:00.000000Z",
        "updated_at": "2024-01-02T15:29:00.000000Z"
    }
]
```

> **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.

> **Controla el peso de la respuesta**
>
> Agrega `?with_binaries=false` para omitir el Base64 y quedarte sólo con la URL de descarga: la
> respuesta puede superar los 10 MB cuando la sesión tiene varias evidencias.

### Respuesta del Endpoint

**status 200**

> **Nota**
>
> La respuesta de este endpoint incluye el arreglo `files[]` con los documentos generados por el
> proceso de verificación. Cada archivo trae una URL firmada de descarga y, por defecto, su
> contenido en Base64.

> **Precaución**
>
> El tamaño de esta respuesta puede llegar a ser bastante grande (+10MB) si se incluyen documentos.

```json
    {
        "data": [
            {
                "object": "VerificationSession",
                "id": "12345abcde",
                "status": "OPEN",
                "result": null,
                "redirect_url": "https://example.com",
                "validations": [
                    "INE",
                    "CURP"
                ],
                "optionals": {
                    "folio": "1001"
                },
                "form_url": "https://example.com/verification/12345abcde",
                "created_at": "2024-01-01T10:00:00.000000Z",
                "updated_at": "2024-01-01T10:10:00.000000Z",
                "readable_created_at": "hace 10 minutos",
                "readable_updated_at": "hace 1 minuto"
            },
            {
                "object": "VerificationSession",
                "id": "67890fghij",
                "status": "FAILED",
                "result": 0,
                "errors": [
                    {
                        "Name": "Verificación de Vida",
                        "Category": "Biometrics",
                        "Result": "Failed",
                        "Output": "Fallido"
                    }
                ],
                "optionals": {
                    "folio": "1002"
                },
                "form_url": "https://example.com/verification/67890fghij",
                "created_at": "2024-01-01T11:00:00.000000Z",
                "updated_at": "2024-01-01T11:05:00.000000Z",
                "readable_created_at": "hace 5 minutos",
                "readable_updated_at": "hace 1 minuto"
            },
            {
                "object": "VerificationSession",
                "id": "abcdef12345",
                "status": "FINISHED",
                "result": 100,
                "redirect_url": "https://example.com",
                "validations": [
                    "INE",
                    "CURP"
                ],
                "optionals": {
                    "folio": "1003"
                },
                "form_url": "https://example.com/verification/abcdef12345",
                "created_at": "2024-01-02T15:00:00.000000Z",
                "updated_at": "2024-01-02T15:30:00.000000Z",
                "readable_created_at": "hace 30 minutos",
                "readable_updated_at": "hace 10 minutos"
            }
        ],
        "meta": {
            "include": [
                "ine",
                "renapo"
            ],
            "pagination": {
                "total": 3,
                "count": 3,
                "per_page": 10,
                "current_page": 1,
                "total_pages": 1
            }
        }
    }
```

**status 401**

```json
    {
        "message": "Unauthorized"
    }
```