Top bancos del usuario por volumen o errores

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

Lista los bancos más frecuentes en las validaciones del usuario durante los últimos 30 días, ordenados por volumen total o por número de errores.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`limit`	query	`integer`	opcional	Número máximo de bancos a devolver. Predeterminado: `10`
`metric`	query	`string`	opcional	Criterio de ordenamiento: volumen total o número de errores. Predeterminado: `volume`

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `InsightsTopBanksAttributes` — Lista de bancos más frecuentes del usuario (últimos 30 días).
Campo	Tipo	Descripción
`metric`	`string`	Métrica de clasificación: `volume` — bancos ordenados por número total de validaciones; `errors` — bancos ordenados por tasa de error.
`scope`	`string`	Alcance del ranking: `self` — solo validaciones del usuario; `global` — todas las validaciones de la plataforma (solo administradores).
`banks`	`array`	Lista de bancos ordenada por la métrica seleccionada.

**Códigos de respuesta** `GET /v1/insights/top-banks`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Lista de bancos más frecuentes del usuario (últimos 30 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-banks`**
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`