Get one client's usage
One client's statement for a period: its spend by type, its calls broken down by day, agent, campaign, number and direction, the numbers and channels it bought, and the margin you made on it.
Reseller accounts only. Request access.
organization_idrequiredmonthstringA calendar month, as YYYY-MM.
date_fromstringFirst day of a custom range, as YYYY-MM-DD. Send with date_to.
date_tostringLast day of a custom range, as YYYY-MM-DD. Send with date_from.
curl -X GET 'https://backend.omnidim.io/api/v1/reseller/usage/clients/{organization_id}' \ -H 'Authorization: Bearer YOUR_API_KEY'
{ "organization_id": 5678, "name": "Demo Client", "date_from": "2026-09-01", "date_to": "2026-09-30", "timezone": "Asia/Kolkata", "currency": "USD", "balance": 38.12, "calls": 380, "summary": { "voice_ai": { "minutes": 412.5, "amount": 61.88 }, "telephony": { "minutes": 0, "amount": 0 }, "phone_numbers": { "count": 1, "amount": 3 }, "channels": { "count": 0, "amount": 0 }, "total_amount": 64.88 }, "margin": { "revenue": 100, "wholesale_cost": 70, "realized_margin": 30, "bonus": 0 }, "by_agent": [ { "agent_id": 901, "name": "Front desk", "calls": 380, "minutes": 412.5, "amount": 61.88, "telephony_minutes": 0, "telephony_amount": 0, "total_amount": 61.88 } ] }
BearerAuthAuthorizationBearer <token>Bearer token authentication. Obtain your API key from the OmniDimension dashboard.
organization_id*integerThe client organization, as listed by GET /reseller/organizations.
month?stringA calendar month, as YYYY-MM.
date_from?stringFirst day of a custom range, as YYYY-MM-DD. Send with date_to.
datedate_to?stringLast day of a custom range, as YYYY-MM-DD. Send with date_from.
dateResponse body
application/jsonThe client's usage and your margin on it for the period.
application/jsonorganization_id?integername?stringdate_from?stringdatedate_to?stringdatetimezone?stringcurrency?stringAlways USD.
balance?numberThe client's balance now.
calls?integersummary?Spend by type. voice_ai and telephony carry minutes
and amount. phone_numbers, channels, call_audit,
asr_eval, whatsapp, sms, email and
channel_renewal carry count and amount. addons is
one line per add-on. whatsapp_activity counts incoming
messages and active chats. total_amount is the sum of
the spend.
margin?by_day?by_agent?by_campaign?campaign_id is null for calls outside a campaign.
by_number?by_direction?purchases?Each phone number rental and channel purchase in the
period. date is the day it was paid, in timezone.