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

Consultar índices de consumo mes a mes

Audiencia: public
Autenticación: API key
Permiso: usage:read_self

Devuelve el consumo mensual de validaciones del usuario autenticado en hasta months meses con consumo, de más reciente a más antiguo. Los meses sin consumo no aparecen.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`months`	query	`integer`	opcional	Número de meses a incluir en el historial (hacia atrás respecto al momento de la consulta). Predeterminado: `6` p. ej. `6`

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`GetUsageHistoryAttributes` — Historial de consumo mensual ordenado de más reciente a más antiguo.
Campo	Tipo	Descripción
`data`	`object`	Cuerpo de la respuesta, en la envoltura JSON:API.
`type`	`string`	Tipo de recurso JSON:API. Siempre `usage_history`. p. ej. `usage_history`
`attributes`	`object`	Datos del historial: Número de meses y lo consumo por mes.
`months`	`integer`	Cantidad de meses que cubre el historial devuelto. p. ej. `6`
`history`	`array`	Un elemento por mes, del más reciente al más antiguo.

**Códigos de respuesta**`GET /v1/usage/history`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Historial de consumo mensual ordenado de más reciente a más antiguo.	`GetUsageHistoryAttributes`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`

**Errores de `GET /v1/usage/history`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`