Skip to main content

getPaymentQuotas

QuotaArrayWrapper getPaymentQuotas(wallet, additional)

GET /api/2.0/portal/payment/quotas

Get the purchasable quotas

Lists the quotas the portal can be put on - the paid plans and the wallet services - each with its price, its features and the limits it grants, which is what a pricing page is built from. Nothing has to be called first, the caller needs the permission to edit the portal settings, and the call is read-only. Only quotas marked visible are listed, newest first, and the two optional filters narrow that: wallet selects the wallet services (true) or the subscription plans (false), additional selects the add-ons to a plan (true) or the plans themselves (false), and an omitted filter keeps both kinds. A portal on a non-profit quota is a special case - asking for additional=false returns that single quota and nothing else, because no other plan may be bought for it. The quota the portal is actually on is not marked here; read it from GET api/2.0/portal/payment/quota.

Parameters​

NameInTypeDescriptionNotes
walletqueryBooleanWhich side of the catalogue is listed: true keeps the services paid out of the portal wallet, false keeps the subscription plans, and omitting it keeps both.[optional] [example: true]
additionalqueryBooleanWhich layer of the catalogue is listed: true keeps the add-ons that extend a plan, false keeps the plans themselves, and omitting it keeps both.[optional] [example: true]

Responses​

Status codeDescriptionTypeResponse headers
200The visible quotas matching the filters, newest first, each with its price, features and limitsQuotaArrayWrapperX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
403The caller has no portal-settings right--
401UnauthorizedErrorApiResponse-
429Too Many Requests.ErrorApiResponseRetry-After
500Internal Server Error.ErrorApiResponse-
400Bad Request.ErrorApiResponse-
502Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON.--
503Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON.--

Return type​

QuotaArrayWrapper

Authorization​

Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json