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

Monthly usage history

Audience
public
Auth
API key
Permission
usage:read_self
How-to guide →

Returns the authenticated user's monthly validation usage for up to months months with usage, most recent first. Months without usage are omitted.

Parameters
ParameterInTypeRequiredDescription
monthsqueryintegeroptional

Number of months to include in the history (counting back from the moment of the query).

Default: 6

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

Response 200GetUsageHistoryAttributes — Monthly usage history ordered from most to least recent.
FieldTypeDescription
dataobject

Response body, in the JSON:API envelope.

typestring

JSON:API resource type. Always usage_history.

e.g. usage_history
attributesobject

History data: the month count and the per-month usage.

monthsinteger

Number of months the returned history covers.

e.g. 6
historyarray

One entry per month, most recent first.

Response status codesGET /v1/usage/history
StatusClassDescriptionBody
2002xxMonthly usage history ordered from most to least recent.GetUsageHistoryAttributes
4014xxAuthentication is required or the provided credentials are invalid.ErrorResponse
4034xxInsufficient permissions.ErrorResponse
Errors from GET /v1/usage/history
StatusCodeExample
401unauthorized

Invalid or missing authentication credentials.

Envelope
meta.request_id
c4d5e6f7a8b99b8a7f6e5d4c
403permission_denied

You do not have permission to access this resource.

Envelope
meta.request_id
d5e6f7a8b9c00c9b8a7f6e5d