# Listar lecturas OCR INE parte frontal

Fuente: /ine-validation/frontal-ocr-ine-list/

Este endpoint te permite obtener, de forma paginada, **las lecturas OCR de la parte frontal de la INE que has
realizado**, de la más reciente a la más antigua. Cada lectura trae los mismos `ocr` y `parse_ocr` que te
regresó el endpoint al hacerla, así que puedes reutilizar el código con el que ya los procesas.

**Método:**   GET

#### **Endpoint**

```
https://api.verificamex.com/identity/v2/ocr/obverse
```

> **Qué lecturas aparecen aquí**
>
> Incluye las lecturas hechas con [OCR INE parte frontal](/ine-validation/frontal-ocr-ine/)
> (`POST /v1/ocr/obverse`) y con su versión `POST /v2/ocr/obverse`. **No** incluye las lecturas del anverso que
> se hacen dentro de una sesión de verificación ni las de una validación completa de INE.

> **Misma URL, distinto método**
>
> La dirección es idéntica a la de `POST /v2/ocr/obverse`, lo que cambia es el método: con
>  POST haces una lectura y con  GET
> consultas el listado.

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

Todos los parámetros son opcionales y se envían en la cadena de consulta:

| Parámetro | Tipo | Descripción |
| - | - | - |
| page | `Integer` | Número de página. Por defecto `1`. |
| limit | `Integer` | Lecturas por página. Por defecto `15`, máximo `100`. |
| from | `String` | Fecha inicial en formato `YYYY-MM-DD`, inclusive. Se compara con la fecha de la lectura. |
| to | `String` | Fecha final en formato `YYYY-MM-DD`, inclusive. Debe ser igual o posterior a `from`. |

### **Ejemplo de Solicitud**

```bash
curl "https://api.verificamex.com/identity/v2/ocr/obverse?limit=15&from=2026-10-01&to=2026-10-15" \
  -H "Authorization: Bearer {TU_TOKEN}" \
  -H "Accept: application/json"
```

### Respuesta del Endpoint

**status 200**

```json
{
    "data": [
        {
            "id": 99804,
            "ocr": "PEREZ LOPEZ JUAN 01/01/1985 ...",
            "parse_ocr": [
                {
                    "name": "Nombre",
                    "type": "Name",
                    "value": "JUAN",
                    "source": "OCR"
                },
                {
                    "name": "Número Personal",
                    "type": "PersonalNumber",
                    "value": "PELJ850101HDFRPN09",
                    "source": "OCR"
                }
            ],
            "created_at": "2026-10-15T11:41:01-06:00"
        }
    ],
    "meta": {
        "pagination": {
            "total": 3,
            "count": 1,
            "per_page": 15,
            "current_page": 1,
            "total_pages": 1
        }
    }
}
```

**status 401**

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

**status 422**

Este error ocurre si algún parámetro no tiene el formato esperado, por ejemplo si `to` es anterior a `from`.

```json
{
    "message": "to debe ser una fecha posterior o igual a from.",
    "errors": {
        "to": [
            "to debe ser una fecha posterior o igual a from."
        ]
    }
}
```

### **Campos de la respuesta**

| Campo | Tipo | Descripción |
| - | - | - |
| data | `Array` | Lecturas de la página solicitada, de la más reciente a la más antigua. |
| data\[].id | `Integer` | Identificador de la lectura. |
| data\[].ocr | `String` | Texto completo leído de la credencial, igual que en la respuesta de la lectura. |
| data\[].parse\_ocr | `Array` | Datos interpretados de la credencial (nombre, CURP, domicilio, etc.), con la misma estructura que en [OCR INE parte frontal](/ine-validation/frontal-ocr-ine/). |
| data\[].created\_at | `String` | Fecha de la lectura en formato ISO 8601. |
| `meta.pagination.total` | `Integer` | Total de lecturas que cumplen los filtros. |
| `meta.pagination.count` | `Integer` | Lecturas en esta página. |
| `meta.pagination.per_page` | `Integer` | Lecturas por página. |
| `meta.pagination.current_page` | `Integer` | Página actual. |
| `meta.pagination.total_pages` | `Integer` | Total de páginas. |

> **Consejo**
>
> Consultar el listado no consume tokens.