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

Get API usage metrics

Returns the authenticated user's API usage metrics:

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`	Number of the user's API key requests on the current calendar day (UTC). e.g. `42`
`requests_month`	`integer`	Number of the user's API key requests in the current calendar month (UTC). e.g. `580`
`quota`	`object`	Current validation quota state: limit, usage, balance, and reset.
`plan_slug`	`string`	Unique, human-readable plan identifier. It corresponds to the user's active plan. e.g. `free`
`plan_name`	`string`	Plan name shown in the interfaces. e.g. `Free`
`limit`	`integer`	Effective validation limit for the current cycle. e.g. `500`
`used`	`integer`	Validations consumed in the current cycle. e.g. `350`
`remaining`	`integer`	Validations available in the current cycle (`max(0, limit - used)`). e.g. `150`
`resets_at`	`string (date-time)`	ISO 8601 timestamp in UTC with an explicit `Z` suffix; for example, `"2026-05-01T05:14:38Z"`. The `_at`, `_end`, `_start`, and `_date` fields follow this format. `meta.datetime` describes the same contract in the response. e.g. `2026-05-01T05:14:38Z`
`recent_requests`	`array`	User's 15 most recent API key requests, from most to least recent.
`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	`ApiUsage`
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 `c4d5e6f7a8b99b8a7f6e5d4c`