User's top banks by volume or errors

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

Lists the most frequent banks in the user's validations over the last 30 days, ranked by total volume or by error count.

Parameters
Parameter	In	Type	Required	Description
`limit`	query	`integer`	optional	Maximum number of banks to return. Default: `10` e.g. `10`
`metric`	query	`string`	optional	What to sort by. `volume` puts the banks with the most validations on top; `errors` puts the ones that fail most on top — rarely the same banks. Default: `volume` e.g. `volume`

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`InsightsTopBanksAttributes` — User's most frequent banks over the last 30 days.
Field	Type	Description
`metric`	`string`	Ranking metric: `volume` — banks ordered by total validations; `errors` — banks ordered by error rate. e.g. `volume`
`scope`	`string`	Ranking scope: `self` — user's validations only; `global` — all platform validations (admin only). e.g. `self`
`banks`	`array`	List of banks ordered by the selected metric.

**Response status codes**`GET /v1/insights/top-banks`
Status	Class	Description	Body
200	`2xx`	User's most frequent banks over the last 30 days.	No body
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`

**Errors from `GET /v1/insights/top-banks`**
Status	Code	Example
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`