Listar lecturas OCR INE parte frontal

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

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

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

{
    "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

{
    "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.

{
    "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.
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.