# Listar sesiones de verificación (V3)

Fuente: /identity-verification-v3/verification-sessions-list/

Este endpoint te permite **obtener el listado paginado de tus sesiones de verificación**, sin importar su estado.

> **El listado es común a las dos versiones**
>
> No existe un endpoint de listado exclusivo de la V3. Esta ruta devuelve **todas** tus sesiones,
> tanto las creadas con la V2 como con la V3, mezcladas en el mismo arreglo. Fíjate en el `/v2/`
> de la URL.

**Método:**   GET

#### **Endpoint**

```
https://api.verificamex.com/identity/v2/identity/sessions
```

> **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 |
| - | - | - |
| page | `Integer` | Número de la página. |
| limit | `Integer` | Número de resultados por página. |
| include | `String` | Muestra los datos relacionados a la sesión. Valores permitidos: `"ine"`, `"renapo"`, `"files"`. |
| `with_binaries` | `Boolean` | Incluye el contenido de cada archivo en Base64. |

> **Cuidado con el peso de la respuesta**
>
> A diferencia del [detalle](/identity-verification-v3/show-verification-session/), el listado
> **sí incluye los archivos en Base64 por defecto**, incluso para las sesiones V3. Con varias
> sesiones por página la respuesta crece muy rápido.
>
> Te recomendamos consultar el listado siempre con `?with_binaries=false` y obtener los archivos
> desde el detalle de la sesión que te interese.

### 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"],
                "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"
            },
            {
                "object": "VerificationSession",
                "id": "1f2a9b44-77c1-4a10-9de3-0b5c2e8f1a30",
                "status": "OPEN",
                "result": null,
                "validations": ["INE", "CURP"],
                "optionals": null,
                "form_url": "https://app.verificamex.com/verification/1f2a9b44-77c1-4a10-9de3-0b5c2e8f1a30",
                "created_at": "2026-07-21T23:10:00.000000Z",
                "updated_at": "2026-07-21T23:10:00.000000Z",
                "readable_created_at": "hace 2 minutos",
                "readable_updated_at": "hace 2 minutos"
            }
        ],
        "meta": {
            "include": ["ine", "renapo"],
            "pagination": {
                "total": 42,
                "count": 2,
                "per_page": 2,
                "current_page": 1,
                "total_pages": 21
            }
        }
    }
```

**status 401**

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

> **Consejo**
>
> El listado no distingue con qué versión se creó cada sesión. Si necesitas separarlas, guarda del
> lado de tu sistema el `uuid` que te devolvió cada endpoint de creación.