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

List the most frequent beneficiaries in the account's validations

Lists the beneficiaries detected most frequently in the authenticated user's validations over the last 90 days.

Each entry includes the beneficiary label, the receiving bank, and the last 4 digits of the account.

Parameters
Parameter	In	Type	Required	Description
`limit`	query	`integer`	optional	Filter — Maximum number of beneficiaries to return. Default: `10` e.g. `10`

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`InsightsTopBeneficiariesAttributes` — Most frequent beneficiaries in the account's validations over the last 90 days.
Field	Type	Description
`beneficiaries`*	`array`	Beneficiary ranking, ordered from highest to lowest by `count` (validations to that beneficiary in the last 90 days).

**Response status codes**`GET /v1/insights/top-beneficiaries`
Status	Class	Description	Body
200	`2xx`	Most frequent beneficiaries in the account's validations over the last 90 days.	`InsightsTopBeneficiariesAttributes`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`

**Errors from `GET /v1/insights/top-beneficiaries`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`