Obtener métricas de uso de la API

GEThttps://api.veriko.mx/v1/api/usage

Audiencia: public
Autenticación: API key
Permiso: validations:read

Devuelve los contadores de uso actual, cuota de rate-limit, solicitudes recientes y estado del servicio Banxico.

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`ApiUsage` — Estadísticas de uso
Campo	Tipo	Descripción
`requests_today`	`integer`	Total de peticiones a la API en el día calendario actual (UTC). p. ej. `42`
`requests_month`	`integer`	Total de peticiones a la API en el mes calendario actual (UTC). p. ej. `580`
`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. p. ej. `free`
`plan_name`	`string`	Nombre legible del plan activo. p. ej. `Free`
`limit`	`integer`	Validaciones incluidas en el plan por mes calendario. p. ej. `500`
`used`	`integer`	Validaciones consumidas en el mes en curso. p. ej. `350`
`remaining`	`integer`	Validaciones restantes en el mes en curso. p. ej. `150`
`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. p. ej. `2026-05-01T05:14:38Z`
`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. p. ej. `operational`
`usage_history`	`array`	Historial de validaciones consumidas por mes calendario.

**Códigos de respuesta**`GET /v1/api/usage`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Estadísticas de uso	Sin cuerpo
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`

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