GEThttps://api.veriko.mx/v1/insights/overview

Consultar las métricas de validaciones de la cuenta de usuario

Devuelve las métricas de validaciones para el usuario autenticado:

Incluye la distribución de veredictos de Banxico de los últimos 7 días.

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`InsightsOverviewAttributes` — KPIs propios del usuario y distribución de veredictos de Banxico de los últimos 7 días.
Campo	Tipo	Descripción
`total`	`integer`	Cantidad de validaciones en el alcance, sin acotar por fecha. p. ej. `1240`
`today`	`integer`	Cantidad de validaciones creadas en el día calendario actual (UTC). p. ej. `37`
`yesterday`	`integer`	Cantidad de validaciones creadas en el día calendario anterior (UTC). p. ej. `42`
`success_rate`	`number`	Porcentaje de validaciones con veredicto `valid` sobre el total, expresado de 0 a 100. p. ej. `94.2`
`avg_latency_ms`	`integer`	Tiempo promedio de procesamiento (en milisegundos) de las últimas 24 horas. p. ej. `810`
`by_banxico_7d`	`object`	Distribución de veredictos de Banxico de los últimos 7 días. Las claves son valores de `banxico_status` (`valid`, `not_found`, `cep_unavailable`, `invalid`, `returned`, `error` o `pending`); los valores ausentes implican cero. p. ej. `{"valid":210,"invalid":8,"not_found":3,"cep_unavailable":2,"returned":1}`
`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`

**Códigos de respuesta**`GET /v1/insights/overview`
Código	Clase	Descripción	Cuerpo
200	`2xx`	KPIs propios del usuario y distribución de veredictos de Banxico de los últimos 7 días.	`InsightsOverviewAttributes`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`

**Errores de `GET /v1/insights/overview`**
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`