GET https://api.veriko.mx/v1/api/usage

Get API usage metrics

Audience
public
Auth
API key
Permission
validations:read
How-to guide →

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

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

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).

requests_month integer

Total API requests in the current calendar month (UTC).

quota object

Active plan validation quota status.

plan_slug string

Active plan identifier.

plan_name string

Human-readable name of the active plan.

limit integer

Validations included in the plan per calendar month.

used integer

Validations consumed in the current month.

remaining integer

Validations remaining in the current month.

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.

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.

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 Detail
401 unauthorized

Invalid or missing authentication credentials.

Envelope
meta.request_id
c4d5e6f7a8b9