← Volver al índice de esquemas

`ApiUsage`

Estadísticas de uso de la API y estado del servicio Banxico. Devuelto por `GET /v1/api/usage`.

Propiedades

Campo	Tipo	Descripción
`requests_today`	`integer`	Total de peticiones a la API en el día calendario actual (UTC).
`requests_month`	`integer`	Total de peticiones a la API en el mes calendario actual (UTC).
`quota`	`object`	Estado de la cuota de validaciones del plan vigente: cuántas incluye, cuántas se llevan consumidas, cuántas quedan y cuándo se reinicia la cuenta.
`plan_slug`	`string`	Identificador del plan activo.
`plan_name`	`string`	Nombre legible del plan activo.
`limit`	`integer`	Validaciones incluidas en el plan por mes calendario.
`used`	`integer`	Validaciones consumidas en el mes en curso.
`remaining`	`integer`	Validaciones restantes en el mes en curso.
`resets_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `_at`, `_end`, `_start`, `_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente.
`recent_requests`	`array`	Últimas peticiones a la API del usuario (orden cronológico inverso).
`banxico_status`	`string`	Estado actual del servicio Banxico CEP: `operational` — disponible y respondiendo con normalidad; `degraded` — disponible pero con errores parciales; `down` — completamente no disponible (todos los registros recientes son errores); `unknown` — sin datos recientes suficientes para determinar el estado.
`usage_history`	`array`	Historial de validaciones consumidas por mes calendario.

Usado en operaciones

GET /v1/api/usage