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

Get the account's validation time series

Returns a time series representing the authenticated user's validations, according to the selected range and metric.

The interval size varies with the range:

The volume metric breaks down into manual (direct) and OCR (ocr) validations.

The latency metric returns the p50, p95, and p99 percentiles.

Parameters
Parameter	In	Type	Required	Description
`metric`	query	`string`	optional	Filter — Series to return. With `volume`, each point contains the validation count; with `latency`, the processing-time percentiles for validations that have that measurement. Default: `volume` e.g. `volume`
`range`	query	`string`	optional	Filter — Time window covered by the series: `24h` (last 24 hours), `7d` (last 7 days), `30d` (last 30 days), or `90d` (last 90 days). The interval size scales with the window, so two queries over different windows are not comparable point by point. Default: `7d` e.g. `7d`

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`InsightsTrendsAttributes` — Time-series intervals for the requested range and metric.
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). e.g. `7d`
`metric`	`string`	Metric represented — `volume`: validation counts stacked by type; `latency`: processing times in percentiles. e.g. `volume`
`scope`	`string`	Data scope — `self`: Only the authenticated user's validations; `global`: All platform validations (administrators only). e.g. `self`
`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`.

**Response status codes**`GET /v1/insights/trends`
Status	Class	Description	Body
200	`2xx`	Time-series intervals for the requested range and metric.	`InsightsTrendsAttributes`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`

**Errors from `GET /v1/insights/trends`**
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`