MCP is live.Set upAsk the community
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCP
Reseller usage

Get usage across your clients

Your whole book for one period: each client's minutes, calls, spend and the margin you made on it, your totals, how long your balance will last, and your recurring revenue.

Reseller accounts only. Request access.

GET/reseller/usage
Query parameters
monthstring

A calendar month, as YYYY-MM.

date_fromstring

First day of a custom range, as YYYY-MM-DD. Send with date_to.

date_tostring

Last day of a custom range, as YYYY-MM-DD. Send with date_from.

curl -X GET 'https://backend.omnidim.io/api/v1/reseller/usage' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example response
{
  "reseller_organization_id": 1234,
  "date_from": "2026-09-01",
  "date_to": "2026-09-30",
  "timezone": "Asia/Kolkata",
  "currency": "USD",
  "totals": {
    "clients": 2,
    "active_clients": 1,
    "total_minutes": 412.5,
    "total_calls": 380,
    "total_consumption": 61.88,
    "total_purchases": 3,
    "total_revenue": 100,
    "total_wholesale_cost": 70,
    "total_realized_margin": 30,
    "margin_pct": 30
  },
  "pool": {
    "balance": 250,
    "wholesale_charged": 70,
    "burn_per_day": 2.33,
    "burn_window_days": 30,
    "runway_days": 107.3
  },
  "business": {
    "mrr": 50,
    "mrr_wholesale": 35,
    "mrr_profit": 15,
    "active_subscriptions": 1,
    "top_client": {
      "organization_id": 5678,
      "name": "Demo Client",
      "realized_margin": 30,
      "share_pct": 100
    },
    "previous_period_realized_margin": 24,
    "realized_margin_change_pct": 25
  },
  "clients": [
    {
      "organization_id": 5678,
      "name": "Demo Client",
      "minutes": 412.5,
      "calls": 380,
      "consumption": 61.88,
      "purchases": 3,
      "numbers_spend": 3,
      "channels_spend": 0,
      "realized_margin": 30,
      "balance": 38.12,
      "runway_days": 18.5
    }
  ]
}

Authorization

BearerAuth
headerAuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

Query Parameters

month?string

A calendar month, as YYYY-MM.

date_from?string

First day of a custom range, as YYYY-MM-DD. Send with date_to.

Formatdate
date_to?string

Last day of a custom range, as YYYY-MM-DD. Send with date_from.

Formatdate

Response body

application/json

Response Body

Usage and margin across your clients for the period.

application/json
reseller_organization_id?integer
date_from?string
Formatdate
date_to?string
Formatdate
timezone?string

The timezone the days are counted in.

currency?string

Always USD.

totals?
pool?

Your own balance and how fast client sales draw it down.

business?
clients?

Disable custom email server

Stop sending your clients' emails through your own email server. Their emails go back to the default sender. The saved server and its login are kept, so you can switch it on again with POST /reseller/identity/smtp/save. Your brand is not changed.

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.