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

Usage breakdown by operation

Breaks down the indicated period's usage by billable operation type (validation and sms_2fa).

The period parameter accepts current for the running month or YYYY-MM for a specific month.

Parameters
Parameter	In	Type	Required	Description
`period`	query	`string`	optional	Period to break down. Accepts `current` for the running month or a `YYYY-MM` string for a specific month. e.g. `current`

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`GetUsageBreakdownAttributes` — Consumption counts by operation type for the requested period.
Field	Type	Description
`data`	`object`	Response body, in the JSON:API envelope.
`type`	`string`	JSON:API resource type. Always `usage_breakdown`. e.g. `usage_breakdown`
`attributes`	`object`	Breakdown data: the period and the per-operation usage.
`period`	`string`	Month the breakdown belongs to, in `YYYY-MM` format. e.g. `2026-04`
`operations`	`array`	One entry per operation type, with what each consumed.

**Response status codes**`GET /v1/usage/breakdown`
Status	Class	Description	Body
200	`2xx`	Consumption counts by operation type for the requested period.	`GetUsageBreakdownAttributes`
400	`4xx`	The `period` parameter format is invalid.	`ErrorResponse`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`

**Errors from `GET /v1/usage/breakdown`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`