Get List of Buckets

To get the list of buckets, use the following request:

GET /billing/buckets.xml

GET /billing/buckets.json

XML Request Example

curl -i -X GET http://onapp.test/billing/buckets.xml -u account_email:API_key -H 'Accept: application/xml' -H 'Content-type: application/xml' 

JSON Request Example

curl -i -X GET http://onapp.test/billing/buckets.json -u account_email:API_key -H 'Accept: application/json' -H 'Content-type: application/json' 

XML Output Example

<buckets type="array">
 <bucket>
   <id type="integer">3</id>
   <label>ut</label>
   <created_at type="dateTime">2017-06-26T08:48:05+00:00</created_at>
   <updated_at type="dateTime">2017-06-26T08:48:05+00:00</updated_at>
   <currency_code>USD</currency_code>
   <show_price nil="true"/>
   <monthly_price type="decimal">1.0</monthly_price>
   <allows_mak type="boolean">true</allows_mak>
   <allows_kms type="boolean">true</allows_kms>
   <allows_own type="boolean">true</allows_own>
   <associated_with_users type="integer">1</associated_with_users>
 </bucket>
</buckets>

Where:

id - the bucket ID

label - the bucket name

created_at - the date in the [YYYY][MM][DD]T[hh][mm][ss]Z format

updated_at - the date when the bucket was updated in the [YYYY][MM][DD]T[hh][mm][ss]Z format

currency_code - the currency in which the users are charged

show_price - true, if users can see the prices set up for them, otherwise false

monthly_price * - the monthly fee for bucket usage

allows_mak - true, if the MAK licensing is allowed, otherwise false

allows_kms - true, if the KMS licensing is allowed for this bucket, otherwise false

allows_own - true, if adding own licenses is allowed for this bucket, otherwise false

associated_with_users - the number of users with which this bucket is associated