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

User's top banks by volume or errors

Audience
public
Auth
API key
Permission
insights:read_self
How-to guide →

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

metric query string optional

Sort criterion: total volume or number of errors.

Default: volume

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

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.

scope string

Ranking scope: `self` — user's validations only; `global` — all platform validations (admin only).

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 Permisos insuficientes ErrorResponse
Errors from GET /v1/insights/top-banks
Status Code Detail
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