Logo
Zoom Public API Documentation

List upcoming renewal accounts

GET {{baseUrl}}/accounts/billing/renewals?interval=30&page_size=<integer>&next_page_token=<string>

List sub accounts' upcoming renewal plans.

Scopes: billing:master,account:master

Rate Limit Label: MEDIUM

 

Body PARAM

Key Datatype Required Description 
interval
number Valid date range. Value is 30, 60, or 90.
page_size
string Page size. Value is less than 50.
next_page_token
string



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "interval": 30, "page_size": "<integer>", "results": [ { "account_id": "<string>", "account_name": "<string>", "account_number": "<string>", "auto_renew": "<boolean>", "email": "<string>", "next_renewal_date": "<Date>", "renewable_subscriptions": [ { "billing_cycle": "Annual", "next_invoice_amount": "<number>", "next_invoice_date": "<Date>", "plan_name": "<string>", "quantity": "<integer>", "service_effective_date": "<Date>" }, { "billing_cycle": "Quarterly", "next_invoice_amount": "<number>", "next_invoice_date": "<Date>", "plan_name": "<string>", "quantity": "<integer>", "service_effective_date": "<Date>" } ], "total_renewal_amount": "<integer>" }, { "account_id": "<string>", "account_name": "<string>", "account_number": "<string>", "auto_renew": "<boolean>", "email": "<string>", "next_renewal_date": "<Date>", "renewable_subscriptions": [ { "billing_cycle": "Annual", "next_invoice_amount": "<number>", "next_invoice_date": "<Date>", "plan_name": "<string>", "quantity": "<integer>", "service_effective_date": "<Date>" }, { "billing_cycle": "Monthly", "next_invoice_amount": "<number>", "next_invoice_date": "<Date>", "plan_name": "<string>", "quantity": "<integer>", "service_effective_date": "<Date>" } ], "total_renewal_amount": "<integer>" } ], "total_records": "<integer>" }



Curl
curl -X GET 'https://api.zoom.us/v2/accounts/billing/renewals?interval=30&page_size=<integer>&next_page_token=<string>?interval=30&page_size=<integer>&next_page_token=<string>' -H 'Accept: application/json'

ENDPOINTS