List assignable plans
Returns all SMAO plans available for assignment to customer organizations.
Trial and enterprise plans are excluded. Each plan includes its slug, commitment
(monthly/yearly), baseFee in the smallest currency unit, and a usage array showing included units
and overage cost per service.
Use the slug and commitment values when creating or updating an organization's plan.
Authorization
DistributorApiKey Long-lived distributor API key, scoped to your distributor account.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/plans"{ "status": "success", "count": 0, "plans": [ { "id": "6967b1c7138bed3e7f6bf7e6", "slug": "string", "name": "string", "commitment": "none", "tier": 0, "currency": "string", "baseFee": 0, "usage": [ { "service": "CALL", "included": 0, "costPerUnit": 0 } ] } ]}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.
Update assigned plan for an organization PATCH
Changes the plan assigned to a customer organization. The change takes effect immediately. The previous subscription is marked as upgraded and a new active subscription is created with the selected plan. If the organization is already on the requested plan, no change is made.