https://api.veriko.mx/v1/insights/trends User's validation time series
How-to guide →Returns a time series for the user by the selected range and metric. Bucket granularity varies with range: 24h → hourly, 7d/30d → daily, 90d → weekly (starting Monday). Metric volume breaks down direct vs OCR; latency returns p50, p95, and p99 percentiles.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
metric | query | string | optional | Metric to plot: validation volume or latency. Default: |
range | query | string | optional | Time window of the series. Default: |
curl -X GET 'https://api.veriko.mx/v1/insights/trends' \
-H 'Authorization: Bearer mxcep_••••'
Python example — coming soon.
JavaScript example — coming soon.
PHP example — coming soon.
| Field | Type | Description |
|---|---|---|
range | string | Time window of the series: `24h` (last 24 hours), `7d` (last 7 days), `30d` (last 30 days), or `90d` (last 90 days). |
metric | string | Metric represented: `volume` — validation counts stacked by type; `latency` — processing times in percentiles. |
scope | string | Data scope: `self` — user's validations only; `global` — all platform validations (admin only). |
series | array | Data points in chronological order. The shape of each point depends on `metric`: for `volume` it includes `bucket`, `total`, `direct`, `ocr`, `valid`, `errored`; for `latency` it includes `bucket`, `p50`, `p95`, `p99`, `avg`. |
| Status | Class | Description | Body |
|---|---|---|---|
| 200 | 2xx | Time series buckets for the requested range and metric. | No body |
| 401 | 4xx | Authentication is required or the provided credentials are invalid. | ErrorResponse |
| 403 | 4xx | Permisos insuficientes | ErrorResponse |
| Status | Code | Detail |
|---|---|---|
| 401 | unauthorized | Invalid or missing authentication credentials. Envelope
|
| 403 | forbidden | You do not have permission to access this resource. Envelope
|