# Listado de sesiones de verificación

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

Este endpoint te permite **obtener el listado de sesiones de verificación** realizadas sin importar su estado `OPEN`, `IN_PROGRESS` o `CLOSED` y paginar los resultados.

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

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

Para paginar los resultados se debe incluir los siguientes parámetros:

| Parámetro | Tipo | Descripción |
| - | - | - |
| page | `String` | Número de la página. |
| limit | `String` | Número de resultados por página. |
| include | `String` | Muestra los datos relacionados a la sesión de verificación. Valores permitidos: `"ine"`, `"renapo"`, `"files"`. |

### **Respuesta del Endpoint**

**status 200**

```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"
    }
```