SMAO API Documentation
Billing

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.

GET
/plans
AuthorizationBearer <token>

Long-lived distributor API key scoped to a channel partner on the shared smao instance.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.smao.ai/api/distributor/v1/plans"
{
  "status": "success",
  "count": 0,
  "plans": [
    {
      "id": "string",
      "slug": "string",
      "name": "string",
      "commitment": "none",
      "tier": 0,
      "currency": "string",
      "baseFee": 0,
      "usage": [
        {
          "service": "CALL",
          "included": 0,
          "costPerUnit": 0
        }
      ]
    }
  ]
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}

{
  "status": "error",
  "errorCode": "RATE_LIMITED",
  "message": "Too many requests for this API key."
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}

{
  "status": "error",
  "errorCode": "RATE_LIMIT_UNAVAILABLE",
  "message": "Rate limit storage is unavailable. Try again shortly."
}