SMAO API Documentation
Distributor API v1Usage

Get aggregated usage for a single partner's organizations

GET
/partners/{partnerId}/usage

Returns aggregated usage across all customer organizations that belong to the specified partner (MSP), plus a per-organization breakdown. Totals are all-or-nothing: if any organization's usage cannot be calculated, the request fails with 500 INTERNAL_ERROR instead of returning a partial total.

Authorization

DistributorApiKey
AuthorizationBearer <token>

Long-lived distributor API key, scoped to your distributor account.

In: header

Path Parameters

partnerId*string

Partner (MSP) ID (24-character hex string).

Match^[a-fA-F0-9]{24}$

Query Parameters

from*string

Start date in YYYY-MM-DD format, inclusive. Must not be after today (UTC).

Formatdate
to*string

End date in YYYY-MM-DD format, inclusive. Must not be after today (UTC), so a window for the current month ends today, not on the last day of the month. Usage windows may cover at most 365 days, billing-summary windows at most 31 days.

Formatdate

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/partners/665abc123def456789012345/usage?from=2019-08-24&to=2019-08-24"
{  "status": "success",  "period": {    "from": "2019-08-24",    "to": "2019-08-24"  },  "totals": {    "calls": {      "count": 0,      "minutes": 0    },    "forwards": {      "count": 0,      "minutes": 0    },    "assistants": 0,    "sms": {      "count": 0,      "segments": 0    },    "whatsapp": 0  },  "organizationCount": 0,  "organizations": [    {      "id": "69c175970f3e28310926a1aa",      "name": "string",      "externalCustomerId": "string",      "usage": {        "calls": {          "count": 0,          "minutes": 0        },        "forwards": {          "count": 0,          "minutes": 0        },        "assistants": 0,        "sms": {          "count": 0,          "segments": 0        },        "whatsapp": 0      }    }  ]}

Get usage for a single organization GET

Get usage for a single organization

Get aggregated usage across all organizations GET

Returns aggregated usage across all customer organizations under this distributor. Optionally filter by `partnerId` to scope results to a single MSP's customers. Totals are all-or-nothing: if any organization's usage cannot be calculated, the request fails with `500 INTERNAL_ERROR` instead of returning a partial total.