GEThttps://api.veriko.mx/v1/status/banxico/timeseries

Banxico health time series (public view)

Audience: public
Auth: API key

Returns the historical operational status of the Banxico validation service, bucketed by time interval for the requested metric and window.

The bucket size depends on the window:

1h: per minute.
8h, 12h, 24h, and 7d: per hour.

It exposes the probe_latency and verdict metrics.

The response is cached 60 seconds on the client with Cache-Control, and that window is set at deploy time. Any authenticated user can query it, and no specific permission is required.

Parameters
Parameter	In	Type	Required	Description
`metric`	query	`string`	optional	Filter — Series to return. With `probe_latency`, each point is the average latency in milliseconds; with `verdict`, the bucket's Banxico verdict (its most recent), encoded as `0`, `1`, or `2`. Default: `probe_latency` e.g. `probe_latency`
`window`	query	`string`	optional	Filter — Window the series covers: `1h`, `8h`, `12h`, `24h` and `7d`. `1h` buckets by minute; the rest bucket by hour. Default: `24h` e.g. `24h`

Request

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/status/banxico/timeseries' \
  -H 'Authorization: Bearer veriko_••••'

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`BanxicoPublicTimeseriesResponse` — Time-series data points.
Field	Type	Description
`data`	`object`	Main response payload. Shape varies by endpoint (object, array, or JSON:API envelope with `type`, `id`, `attributes`).
`type`*	`string`	JSON:API resource type. Always `banxico_public_timeseries`. e.g. `banxico_public_timeseries`
`id`*	`string`	Identifier derived from the metric/window pair (`<metric>_<window>`). e.g. `probe_latency_24h`
`attributes`*	`object`	Time series of Banxico validation service health metrics, bucketed by time interval, as returned by `GET /v1/status/banxico/timeseries`.
`metric`	`string`	Reported metric — `probe_latency`: average health probe latency in milliseconds; `verdict`: the bucket's Banxico verdict, encoded as a number. e.g. `probe_latency`
`window`	`string`	Total time window covered by the series (`1h`, `8h`, `12h`, `24h`, or `7d`). e.g. `24h`
`unit`	`string`	Unit of the values — `ms`: milliseconds, when `metric` is `probe_latency`; `verdict`: a categorical code rather than a magnitude, when `metric` is `verdict`. e.g. `ms`
`bucket_size_minutes`	`integer`	Size of each interval in minutes — `1`: For the `1h` window; `60`: For the `8h`, `12h`, `24h` and `7d` windows. e.g. `60`
`points`	`array`	Data points in chronological order. Each point contains `ts` (bucket start timestamp) and `value` (number in ms for `probe_latency`; verdict code for `verdict`).
`meta`	`object`	Response metadata including API version, route prefix, unique request identifier, and the server timestamp in UTC.
`version`	`string`	API version that processed the request. e.g. `1.47.0`
`api_version`	`string`	API route prefix version (e.g. `v1`). e.g. `v1`
`request_id`	`string`	Unique request identifier (hex). e.g. `a1b2c3d4e5f66f5e4d3c2b1a`
`datetime`	`object`	Companion descriptor present in the `meta` block of every response (and in the `meta` of outgoing webhook bodies). Lets clients assert the timezone contract without re-reading the spec. e.g. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Always `UTC`: The canonical timezone for every datetime field in the body. e.g. `UTC`
`format`*	`string`	Always `ISO 8601`: Explicit `Z` suffix on every datetime. e.g. `ISO 8601`
`links`	`object`	Pagination or related links, present only when the endpoint returns a paginated collection.

**Response status codes**`GET /v1/status/banxico/timeseries`
Status	Class	Description	Body
200	`2xx`	Time-series data points.	`BanxicoPublicTimeseriesResponse`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`

**Response headers**`200`
Header	Type	Description
`Cache-Control`	`string`	Public-view cache TTL (configurable; defaults to 60 s).
`Vary`	`string`	Origin-based variation (CORS).

**Errors from `GET /v1/status/banxico/timeseries`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`