GEThttps://api.veriko.mx/v1/insights/top-beneficiaries

Listar los beneficiarios más frecuentes en las validaciones de la cuenta de usuario

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

Lista los beneficiarios detectados con mayor frecuencia en las validaciones del usuario autenticado durante los últimos 90 días.

Cada entrada incluye la etiqueta del beneficiario, el banco receptor y los últimos 4 dígitos de la cuenta.

Parámetros
ParámetroUbicaciónTipoObligatorioDescripción
limitqueryintegeropcional

Filtro — Número máximo de beneficiarios a devolver.

Predeterminado: 10

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Respuesta 200InsightsTopBeneficiariesAttributes — Beneficiarios más frecuentes en las validaciones de la cuenta de usuario (últimos 90 días).
CampoTipoDescripción
beneficiaries*array

Ranking de beneficiarios, ordenado de mayor a menor por count (validaciones hacia ese beneficiario en los últimos 90 días).

Códigos de respuestaGET /v1/insights/top-beneficiaries
CódigoClaseDescripciónCuerpo
2002xxBeneficiarios más frecuentes en las validaciones de la cuenta de usuario (últimos 90 días).InsightsTopBeneficiariesAttributes
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
4034xxPermisos insuficientesErrorResponse
Errores de GET /v1/insights/top-beneficiaries
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b99b8a7f6e5d4c
403permission_denied

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c00c9b8a7f6e5d