Consultar el estado del servicio de Banxico

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

Audiencia: public
Autenticación: API key

Devuelve el estado operativo actual del servicio de verificación CEP de Banxico, derivado de chequeos periódicos de salud. Pensado para health badges en dashboards de clientes; oculta los detalles internos del monitoreo. La respuesta se cachea 60 s en cliente vía Cache-Control (configurable por despliegue). Requiere autenticación por API key para identificar al llamador en logs y métricas, pero no exige un permiso específico — cualquier usuario autenticado puede consultarlo. Cuando el estado es degraded o down, las validaciones síncronas pueden devolver 503 banxico_rate_limit_exhausted; configura PUT /v1/validations/{id}/retry-policy para reintentar automáticamente al volver el servicio.

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`BanxicoPublicStatusResponse` — Estado actual del servicio Banxico CEP.
Campo	Tipo	Descripción
`data`	`object`	Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
`type`*	`string`	Tipo del recurso JSON:API. Siempre `banxico_status`. p. ej. `banxico_status`
`id`*	`string`	Identificador fijo `current` (la entrada del estado actual). p. ej. `current`
`attributes`*	`object`	Estado público del servicio Banxico CEP. Devuelto por `GET /v1/banxico/status` sin autenticación. Muestra el estado operativo actual y una explicación legible.
`status`*	`string`	Estado agregado del servicio: `operational` — todos los checks pasan y la latencia es normal; `degraded` — problemas parciales (latencia elevada, errores intermitentes); `down` — servicio inaccesible; `unknown` — aún no hay datos de health checks disponibles. p. ej. `operational`
`status_label`*	`string`	Etiqueta legible del estado actual, resuelta al idioma del request. p. ej. `Operativo`
`message`*	`string`	Explicación corta del estado actual del servicio, resuelta al idioma del request. p. ej. `El servicio de verificación está operando normalmente.`
`last_verified_at`*	`TimestampUTC \| null`	Timestamp del último health check ejecutado. `null` si aún no se ha ejecutado ningún check. p. ej. `2026-04-11T15:30:00Z`
`estimated_recovery_at`	`TimestampUTC \| null`	Tiempo estimado de recuperación del servicio. Solo se establece cuando el estado es `degraded` y se conoce una ventana de recuperación esperada. `null` en todos los demás estados. p. ej. `null`
`check_interval_seconds`	`integer`	Cadencia (en segundos) del health check automático completo — la fuente de verdad que la página de estado usa para mostrar "se actualiza cada X" y la cuenta regresiva al próximo chequeo. Se toma en vivo de la tarea programada editable `health-banxico-check`, así que un admin puede retunearla sin desplegar. Cae a 300 cuando la tarea no existe o usa un calendario cron. p. ej. `300`
`meta`	`object`	Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.
`version`	`string`	Versión de la API que procesó la petición. p. ej. `1.47.0`
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`). p. ej. `v1`
`request_id`	`string`	Identificador único de la petición (hex). p. ej. `a1b2c3d4e5f6`
`datetime`	`object`	Descriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec. p. ej. `{"timezone":"UTC","format":"ISO 8601"}`
`timezone`*	`string`	Siempre `UTC` — la zona canónica para cada campo datetime del cuerpo. p. ej. `UTC`
`format`*	`string`	Siempre `ISO 8601` — sufijo `Z` explícito en cada datetime. p. ej. `ISO 8601`
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

**Códigos de respuesta**`GET /v1/status/banxico`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Estado actual del servicio Banxico CEP.	`BanxicoPublicStatusResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	TTL de caché para la vista pública (configurable; default 60 s).
`Vary`	`string`	Indicador de variación por Origin (CORS).

**Errores de `GET /v1/status/banxico`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b9`