Banxico health time series (public view)

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

Audience: public
Auth: API key

Returns data points bucketed by time interval for the requested metric and window. The public view only exposes safe metrics (probe_latency and verdict); values outside the enums do not cause 422 — they silently fall back to defaults (probe_latency, 24h). The response is cached 60 s on the client. Requires API key authentication with no specific permission.

Parameters
Parameter	In	Type	Required	Description
`metric`	query	`string`	optional	Metric to fetch. `probe_latency` returns latency in milliseconds; `verdict` returns the categorical Banxico verdict per bucket. Default: `probe_latency` e.g. `probe_latency`
`window`	query	`string`	optional	Window the series covers: `1h`, `8h`, `12h`, and `24h` to look at the current day in varying detail, and `7d` for the week. As with the other series, the bucket size scales with the requested window. 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 CEP service health metrics in time buckets. Returned by `GET /v1/banxico/timeseries`.
`metric`	`string`	Reported metric: `probe_latency` — health probe latency in milliseconds; `verdict` — Banxico verdict distribution per bucket. 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 measurement for values: `ms` for `probe_latency`, `verdict` (integer 0/1/2) for `verdict`. e.g. `ms`
`bucket_size_minutes`	`integer`	Size of each time bucket in minutes. e.g. `30`
`points`	`array`	Data points in chronological order. Each point contains `ts` (bucket start timestamp) and `value` (integer in ms for `probe_latency`, verdict integer 0/1/2 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. `a1b2c3d4e5f6`
`datetime`	`object`	Companion descriptor present in every response's meta block (and in outgoing webhook payloads). 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.
`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 `c4d5e6f7a8b9`