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

Listar los bancos de la cuenta de usuario por volumen de validaciones o tasa de error

Lista los bancos usados en las validaciones del usuario autenticado durante los últimos 30 días, ordenados por volumen total o por tasa de error.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`limit`	query	`integer`	opcional	Filtro — Número máximo de bancos a devolver. Predeterminado: `10` p. ej. `10`
`metric`	query	`string`	opcional	Filtro — Criterio de ordenación. `volume` pone arriba los bancos con más validaciones; `errors`, los de mayor tasa de error. Predeterminado: `volume` p. ej. `volume`

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`InsightsTopBanksAttributes` — Bancos del usuario ordenados según la métrica solicitada (últimos 30 días).
Campo	Tipo	Descripción
`metric`	`string`	Métrica de clasificación — `volume`: bancos ordenados por cantidad de validaciones; `errors`: bancos ordenados por tasa de error. p. ej. `volume`
`scope`	`string`	Alcance de los datos — `self`: Solo las validaciones del usuario autenticado; `global`: Todas las validaciones de la plataforma (solo para administradores). p. ej. `self`
`banks`	`array`	Lista de bancos ordenada según la métrica seleccionada.

**Códigos de respuesta**`GET /v1/insights/top-banks`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Bancos del usuario ordenados según la métrica solicitada (últimos 30 días).	`InsightsTopBanksAttributes`
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	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`