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

Obtener métricas de uso de la API

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

Devuelve las métricas de uso de la API del usuario autenticado:

Peticiones con clave de API hoy y en el mes.
Cuota del plan vigente.
Últimas 15 peticiones con clave de API.
Validaciones consumidas por mes.
Estado actual del servicio Banxico CEP.

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`	Cantidad de peticiones del usuario con clave de API en el día calendario actual (UTC). p. ej. `42`
`requests_month`	`integer`	Cantidad de peticiones del usuario con clave de API en el mes calendario actual (UTC). p. ej. `580`
`quota`	`object`	Estado de la cuota de validaciones vigente: límite, consumo, saldo y reinicio.
`plan_slug`	`string`	Identificador único y legible del plan. Corresponde al plan activo del usuario. p. ej. `free`
`plan_name`	`string`	Nombre del plan que muestran las interfaces. p. ej. `Free`
`limit`	`integer`	Límite efectivo de validaciones para el ciclo actual. p. ej. `500`
`used`	`integer`	Validaciones consumidas en el ciclo actual. p. ej. `350`
`remaining`	`integer`	Validaciones disponibles en el ciclo actual (`max(0, limit - used)`). p. ej. `150`
`resets_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `_at`, `_end`, `_start` y `_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. p. ej. `2026-05-01T05:14:38Z`
`recent_requests`	`array`	Últimas 15 peticiones del usuario con clave de API, de la más reciente a la más antigua.
`banxico_status`	`string`	Estado actual del servicio Banxico CEP — `operational`: Servicio completamente disponible; `degraded`: Disponible pero con errores parciales; `down`: Completamente no disponible; `unknown`: Sin datos suficientes para determinar el estado. p. ej. `operational`
`usage_history`	`array`	Historial de validaciones consumidas por el usuario (por mes calendario).

**Códigos de respuesta**`GET /v1/api/usage`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Estadísticas de uso	`ApiUsage`
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 `c4d5e6f7a8b99b8a7f6e5d4c`