GET https://api.veriko.mx/v1/insights/top-beneficiaries

Beneficiarios frecuentes del usuario

Audiencia
public
Autenticación
API key
Permiso
insights:read_self
Guía de uso →

Lista los beneficiarios a los que el usuario validó con mayor frecuencia durante los últimos 90 días. Cada entrada incluye la etiqueta guardada (si el beneficiario está registrado), el banco y los últimos 4 dígitos de la cuenta.

Parámetros
Parámetro Ubicación Tipo Obligatorio Descripción
limit query integer opcional

Número máximo de beneficiarios a devolver.

Predeterminado: 10

Petición
curl -X GET 'https://api.veriko.mx/v1/insights/top-beneficiaries' \
  -H 'Authorization: Bearer mxcep_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Respuesta 200 InsightsTopBeneficiariesAttributes — Beneficiarios más frecuentes del usuario en los últimos 90 días.
Campo Tipo Descripción
beneficiaries * array

Ranking de beneficiarios ordenado descendente por `count` (validaciones hacia ese beneficiario en los últimos 90 días). Hasta 5 entradas.

Códigos de respuesta GET /v1/insights/top-beneficiaries
Código Clase Descripción Cuerpo
200 2xx Beneficiarios más frecuentes del usuario en los últimos 90 días. Sin cuerpo
401 4xx Se requiere autenticación o las credenciales son inválidas ErrorResponse
403 4xx Permisos insuficientes ErrorResponse
Errores de GET /v1/insights/top-beneficiaries
Código Clave Detalle
401 unauthorized

Invalid or missing authentication credentials.

Envelope
meta.request_id
c4d5e6f7a8b9
403 forbidden

You do not have permission to access this resource.

Envelope
meta.request_id
d5e6f7a8b9c0