Usage

Get spend breakdown

get/client/usage/spend

Return exact live spend (USD) grouped by verification type, country, and day. Sums price_usd_at_call net of reversals.

Authorization

Bearer token in the Authorization header.

Query parameters

startDatestring

endDatestring

Response

currencystringrequired

totalobjectrequired

Show child attributes

countintegerrequired

spendUsdstringrequired

Decimal USD string

byTypeobject[]required

Show child attributes

typestringrequired

countintegerrequired

spendUsdstringrequired

Decimal USD string

byCountryobject[]required

Show child attributes

countrystring | nullrequired

countintegerrequired

spendUsdstringrequired

Decimal USD string

byDayobject[]required

Show child attributes

datestringrequired

countintegerrequired

spendUsdstringrequired

Decimal USD string

const response = await fetch('https://api.lira.com/api/v1/client/usage/spend', { method: 'GET', headers: { 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', }, }); const data = await response.json();

{ "currency": "USD", "total": { "count": 357, "spendUsd": "125.5000" }, "byType": [ { "type": "ACCOUNT_NUMBER", "count": 357, "spendUsd": "125.5000" } ], "byCountry": [ { "country": "NG", "count": 357, "spendUsd": "125.5000" } ], "byDay": [ { "date": "2026-06-01", "count": 357, "spendUsd": "125.5000" } ] }