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

View the account's validation metrics

Returns the validation metrics for the authenticated user:

Includes the Banxico verdict distribution for the last 7 days.

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`InsightsOverviewAttributes` — User-scoped KPIs and Banxico verdict distribution for the last 7 days.
Field	Type	Description
`total`	`integer`	Number of validations in the scope, with no date bound. e.g. `1240`
`today`	`integer`	Number of validations created on the current calendar day (UTC). e.g. `37`
`yesterday`	`integer`	Number of validations created on the previous calendar day (UTC). e.g. `42`
`success_rate`	`number`	Percentage of validations with a `valid` verdict out of the total, expressed from 0 to 100. e.g. `94.2`
`avg_latency_ms`	`integer`	Average processing time over the last 24 hours, in milliseconds. e.g. `810`
`by_banxico_7d`	`object`	Banxico verdict distribution for the last 7 days. Keys are `banxico_status` values (`valid`, `not_found`, `cep_unavailable`, `invalid`, `returned`, `error`, or `pending`); missing values imply zero. e.g. `{"valid":210,"invalid":8,"not_found":3,"cep_unavailable":2,"returned":1}`
`scope`	`string`	Data scope — `self`: Only the authenticated user's validations; `global`: All platform validations (administrators only). e.g. `self`

**Response status codes**`GET /v1/insights/overview`
Status	Class	Description	Body
200	`2xx`	User-scoped KPIs and Banxico verdict distribution for the last 7 days.	`InsightsOverviewAttributes`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`

**Errors from `GET /v1/insights/overview`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`