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

Consultar el estado del servicio de verificación de Banxico

Audiencia
public
Autenticación
API key

Devuelve el estado operativo actual del servicio de verificación de Banxico, derivado de chequeos periódicos de salud.

El estado puede ser:

  • operational: Todos los chequeos pasan y la latencia es normal.
  • degraded: Problemas parciales — latencia elevada o errores intermitentes.
  • down: El servicio es por el momento inaccesible.
  • unknown: No hay datos de salud vigentes: aún no se ha ejecutado ningún chequeo, o el último es más viejo que tres veces check_interval_seconds porque el chequeo automático dejó de correr. En ese caso last_verified_at conserva la fecha de ese último chequeo.

La respuesta se cachea 60 segundos en el cliente con Cache-Control, y ese plazo se configura en el despliegue. Cualquier usuario autenticado puede consultarlo, y no hace falta ningún permiso concreto.

Petición
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 200BanxicoPublicStatusResponse — Estado actual del servicio de verificación de Banxico.
CampoTipoDescripción
dataobject

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. Siempre current.

p. ej. current
attributes*object

Estado público del servicio de verificación de Banxico, tal como lo devuelve GET /v1/status/banxico. Muestra el estado operativo actual y una explicación legible.

status*string

Estado agregado del servicio de verificación de Banxico — operational: Todas las pruebas pasan y la latencia es normal; degraded: Problemas parciales (latencia elevada o errores intermitentes); down: Servicio inaccesible; unknown: no hay datos de salud vigentes, porque aún no se ha ejecutado ningún chequeo o porque el último tiene más de tres veces check_interval_seconds de antigüedad (el chequeo automático dejó de correr).

p. ej. operational
status_label*string

Etiqueta legible del estado actual (resuelta según idioma de la llamada).

p. ej. Operativo
message*string

Explicación corta del estado actual del servicio de verificación de Banxico (resuelta según idioma de la llamada).

p. ej. El servicio de verificación está operando normalmente.
last_verified_at*TimestampUTC | null

Timestamp del último chequeo de salud ejecutado. null cuando aún no se ha ejecutado ningún chequeo. Cuando status es unknown por un chequeo demasiado viejo, conserva la fecha de ese chequeo: dice desde cuándo no hay dato.

p. ej. 2026-04-11T15:30:00Z
estimated_recovery_atTimestampUTC | null

Tiempo estimado de recuperación del servicio de verificación de Banxico. Solo se establece para cierto tipo de degradación transitoria con una ventana de recuperación conocida; null en cualquier otro caso, incluidos los demás tipos de degraded.

p. ej. null
check_interval_secondsinteger

Cadencia (en segundos) del chequeo de salud automático que alimenta este estado. Se lee en vivo de la tarea programada, así que un cambio surte efecto sin desplegar; cuando no hay ninguna cadencia configurada, son 300.

p. ej. 300
metaobject

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.

versionstring

Versión de la API que procesó la petición.

p. ej. 1.47.0
api_versionstring

Versión del prefijo de ruta de la API (ej. v1).

p. ej. v1
request_idstring

Identificador único de la petición (hex).

p. ej. a1b2c3d4e5f66f5e4d3c2b1a
datetimeobject

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
linksobject

Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

Códigos de respuestaGET /v1/status/banxico
CódigoClaseDescripciónCuerpo
2002xxEstado actual del servicio de verificación de Banxico.BanxicoPublicStatusResponse
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
Cabeceras de respuesta200
CabeceraTipoDescripción
Cache-ControlstringTTL de caché para la vista pública (configurable; default 60 s).
VarystringIndicador de variación por Origin (CORS).
Errores de GET /v1/status/banxico
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b99b8a7f6e5d4c