# Scope for "Get Plan Usage"

**URL:** <https://devforum.zoom.us/t/scope-for-get-plan-usage/38604>\
**Category:** API and Webhooks\
**Created:** [December 17, 2020, 6:55am UTC](https://devforum.zoom.us/t/scope-for-get-plan-usage/38604 "2020-12-17T06:55:50Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![danield5s](https://avatars.discourse-cdn.com/v4/letter/d/e47c2d/32.png) [@danield5s](https://devforum.zoom.us/u/danield5s)\
**Post date:** [December 17, 2020, 6:55am UTC](https://devforum.zoom.us/t/scope-for-get-plan-usage/38604/1 "2020-12-17T06:55:50Z")

</div>

**Description**  
According to the documentation, the “Get Plan Usage” endpoint “/accounts/me/plans/usage” apparently requires the “billing:master” scope. However it seems that the scope actually required is account:read:admin or account:write:admin. Is the documentation inaccurate?

**Error**  
Invalid access token, does not contain scopes: [account:read:admin, account:write:admin].

**Which App Type (OAuth / Chatbot / JWT / Webhook)?**  
OAuth

**Which Endpoint/s?**  
/accounts/me/plans/usage

**How To Reproduce (If applicable)**  
Steps to reproduce the behavior:  
Request using token with only the account:read:admin scope, and see that the request succeeds.  
Request using token without the scope and see above error.

---

<div class="post-metadata">

**Author:** ![MaxM](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/maxm/32/42303_2.png) [@MaxM](https://devforum.zoom.us/u/MaxM)\
**Post date:** [December 17, 2020, 7:57pm UTC](https://devforum.zoom.us/t/scope-for-get-plan-usage/38604/2 "2020-12-17T19:57:46Z")

</div>

Hey @danield5s,

Thank you for reaching out to the Zoom Developer Forum. I’m thinking this might have to do with the account being requested. Looking at the `billing:master` permission, it may only pertain to sub-accounts.

![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/8/2/821939f1698025f0d580d012dbb744e4e9391845.png)

Would you be able to try this same request but instead of using `/me` make the request for a sub-account?

I hope that helps!

Thanks,  
Max

---

<div class="post-metadata">

**Author:** ![danield5s](https://avatars.discourse-cdn.com/v4/letter/d/e47c2d/32.png) [@danield5s](https://devforum.zoom.us/u/danield5s)\
**Post date:** [December 18, 2020, 6:32am UTC](https://devforum.zoom.us/t/scope-for-get-plan-usage/38604/3 "2020-12-18T06:32:03Z")

</div>

Hi Max,

Yes it looks like you are right, requesting plan usage with an account id provided instead of “me” results in a response indicating required scopes are “[billing:write:master, billing:read:master, billing:master]”.

I think then that this API will work for our use case since only the current account will be queried, however this is not clear from the documentation. It would be helpful if the documentation mentioned the different scope requirement for when the “me” parameter is used.

Thanks,  
Daniel

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [December 18, 2020, 8:54pm UTC](https://devforum.zoom.us/t/scope-for-get-plan-usage/38604/4 "2020-12-18T20:54:34Z")

</div>

Hey @danield5s,

Happy to hear @MaxM helped with your question! 🙂

Thanks for the feedback about the docs, we will update them shortly. CC @shrijana.g

-Tommy

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/6/1/614bdd549b610bbaa46ff934617683a02bdaa03c.png) [@system](https://devforum.zoom.us/u/system)\
**Post date:** [January 18, 2021, 6:54am UTC](https://devforum.zoom.us/t/scope-for-get-plan-usage/38604/5 "2021-01-18T06:54:38Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.