Get API usage metrics

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

Returns current usage counters, rate-limit quota, recent requests, and Banxico service status.

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`ApiUsage` — Usage statistics
Field	Type	Description
`requests_today`	`integer`	Total API requests on the current calendar day (UTC). e.g. `42`
`requests_month`	`integer`	Total API requests in the current calendar month (UTC). e.g. `580`
`quota`	`object`	Validation quota state for the plan in force: how many it includes, how many have been used, how many remain, and when the count resets.
`plan_slug`	`string`	Active plan identifier. e.g. `free`
`plan_name`	`string`	Human-readable name of the active plan. e.g. `Free`
`limit`	`integer`	Validations included in the plan per calendar month. e.g. `500`
`used`	`integer`	Validations consumed in the current month. e.g. `350`
`remaining`	`integer`	Validations remaining in the current month. e.g. `150`
`resets_at`	`string (date-time)`	ISO 8601 timestamp in UTC with explicit `Z` suffix. Example: `"2026-05-01T05:14:38Z"`. Every datetime field uses this shape. The descriptor at `meta.datetime` makes the contract runtime-assertable. e.g. `2026-05-01T05:14:38Z`
`recent_requests`	`array`	User's most recent API requests (reverse chronological order).
`banxico_status`	`string`	Current Banxico CEP service status: `operational` — available and responding normally; `degraded` — available but with partial errors; `down` — completely unavailable (all recent records are errors); `unknown` — insufficient recent data to determine status. e.g. `operational`
`usage_history`	`array`	Validations consumed per calendar month (history).

**Response status codes**`GET /v1/api/usage`
Status	Class	Description	Body
200	`2xx`	Usage statistics	No body
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`

**Errors from `GET /v1/api/usage`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`