# Listar archivos de una sesión de verificación (V3)

Fuente: /identity-verification-v3/verification-session-files-list/

Este endpoint te permite **obtener el listado de archivos** generados durante el proceso de una
sesión de verificación en específico, filtrando por el `id` de la sesión.

> **A diferencia de otros endpoints de la V3**
>
> Crear, listar sesiones y mostrar el detalle usan rutas de la V2 (ver
> [Mostrar sesión de verificación](/identity-verification-v3/show-verification-session/)). Este
> endpoint sí es una ruta propia de la V3, equivalente a la que ya existía en la
> [V2](/identity-verification/verification-session-files-list/). Fíjate en el `/v3/` de la URL.

Es equivalente a consultar [Mostrar sesión de verificación](/identity-verification-v3/show-verification-session/)
con `?include=files`, pero regresa únicamente el arreglo de archivos sin el resto del detalle de la
sesión.

**Método:**   GET

#### **Endpoint**

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

> **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 (`uuid`) de la sesión de verificación. |

#### **Query Parameters**

| Parámetro | Tipo | Descripción |
| - | - | - |
| `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 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`.

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

```json
    {
        "data": [
            {
                "object": "VerificationFiles",
                "id": "a12f34cd",
                "file_type": "FACE",
                "mime_type": "image/jpeg",
                "size": 198342,
                "url": "https://storage.googleapis.com/...&X-Goog-Signature=...",
                "binary": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
                "created_at": "2026-07-21T22:47:00.000000Z",
                "updated_at": "2026-07-21T22:47:00.000000Z"
            },
            {
                "object": "VerificationFiles",
                "id": "b7e20f91",
                "file_type": "CROP_DOCUMENT_PORTRAIT",
                "mime_type": "image/jpeg",
                "size": 41275,
                "url": "https://storage.googleapis.com/...&X-Goog-Signature=...",
                "binary": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
                "created_at": "2026-07-21T22:47:01.000000Z",
                "updated_at": "2026-07-21T22:47:01.000000Z"
            },
            {
                "object": "VerificationFiles",
                "id": "9d8058ab",
                "file_type": "INE_FRONT",
                "mime_type": "image/jpeg",
                "size": 284736,
                "url": "https://storage.googleapis.com/...&X-Goog-Signature=...",
                "binary": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
                "created_at": "2026-07-21T22:47:02.000000Z",
                "updated_at": "2026-07-21T22:47:02.000000Z"
            }
        ]
    }
```

**status 401**

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

> **Consejo**
>
> ¿Necesitas un solo archivo en lugar del listado completo? Usa
> [Mostrar un archivo de una sesión](/identity-verification-v3/verification-session-file-show/).