# Access currently\_entitled\_tiers using identity scope

**URL:** <https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029>\
**Category:** API Feedback\
**Created:** [April 19, 2020, 11:50pm UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029 "2020-04-19T23:50:45Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![sffc](https://yyz2.discourse-cdn.com/flex036/user_avatar/www.patreondevelopers.com/sffc/32/1284_2.png) [@sffc](https://www.patreondevelopers.com/u/sffc)\
**Post date:** [April 19, 2020, 11:50pm UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029/1 "2020-04-19T23:50:45Z")

</div>

When a user links their Patreon and I get an OAuth token for them, I can use the /api/oauth2/v2/identity endpoint to access limited information about their pledge to my campaign, such as “currently\_entitled\_amount\_cents”. However, in order to get “currently\_entitled\_tiers”, which is available via /api/oauth2/v2/members, I have to use my own personal OAuth token.

I would like there to be a way to get “currently\_entitled\_tiers” by either including it in the /api/oauth2/v2/identity endpoint, or by allowing the identity scope to allow access to /api/oauth2/v2/members but only for the current campaign.

---

<div class="post-metadata">

**Author:** ![sffc](https://yyz2.discourse-cdn.com/flex036/user_avatar/www.patreondevelopers.com/sffc/32/1284_2.png) [@sffc](https://www.patreondevelopers.com/u/sffc)\
**Post date:** [April 20, 2020, 1:36am UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029/2 "2020-04-20T01:36:48Z")

</div>

I figured out how to do it: add “memberships.currently\_entitled\_tiers” to the include:

[https://www.patreon.com/api/oauth2/v2/identity?include=memberships,memberships.currently\_entitled\_tiers](https://www.patreon.com/api/oauth2/v2/identity?include=memberships,memberships.currently_entitled_tiers)

---

<div class="post-metadata">

**Author:** ![FMaz](https://yyz2.discourse-cdn.com/flex036/user_avatar/www.patreondevelopers.com/fmaz/32/2822_2.png) [@FMaz](https://www.patreondevelopers.com/u/FMaz)\
**Post date:** [December 9, 2024, 3:52pm UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029/3 "2024-12-09T15:52:48Z")

</div>

That worked very good, thank you from 4 years later and the documentation still not being clear about how to do this!

---

<div class="post-metadata">

**Author:** ![codebard](https://yyz2.discourse-cdn.com/flex036/user_avatar/www.patreondevelopers.com/codebard/32/14_2.png) [@codebard](https://www.patreondevelopers.com/u/codebard)\
**Post date:** [January 7, 2025, 3:56pm UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029/4 "2025-01-07T15:56:57Z")

</div>

The relations are documented in the docs - if you are using the identity endpoint, you would need to request currently\_entitled\_tiers as a relation.

---

<div class="post-metadata">

**Author:** ![FMaz](https://yyz2.discourse-cdn.com/flex036/user_avatar/www.patreondevelopers.com/fmaz/32/2822_2.png) [@FMaz](https://www.patreondevelopers.com/u/FMaz)\
**Post date:** [January 7, 2025, 4:22pm UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029/5 "2025-01-07T16:22:19Z")

</div>

I will admit that I might not be the best at English reading comprehension, but one of the main thing I imagine someone wants to do with the API is: know what’s the subscriber’s tier a user is entitled to.

And that took me way longer to figure out than I would have expected.

(I can understand why a lot of app creators chose to publish a monthly post with a code instead of implementing the API. It’s really not as intuitive as it could be to understand. And examples are limited to some -in my opinion- odd scenarios)

Even the solution I came up with does not fill me with confidence if I have to be honnest. The info is deeply nested, and, side tracking a bit, it seems the delete webhook instantly notify of a member unsubscribing even if they are still entitled to their benefits until the end of the month.

Not sure what’s the best implementation aproach to handle that. I read the doc multiple times but nothing obvious jumped to me.

Are there good examples or up to date tutorials documenting how to check a member’s entitled tier, and how to handle a member demoting or unsubcribing?

If there isn’t, I’d be happy to help contributing to something (and be corrected where I may have gone wrong)

Hopefully this feedback is constructive as I don’t mean to come accross as just complaining.

---

<div class="post-metadata">

**Author:** ![codebard](https://yyz2.discourse-cdn.com/flex036/user_avatar/www.patreondevelopers.com/codebard/32/14_2.png) [@codebard](https://www.patreondevelopers.com/u/codebard)\
**Post date:** [January 16, 2025, 7:21pm UTC](https://www.patreondevelopers.com/t/access-currently-entitled-tiers-using-identity-scope/3029/6 "2025-01-16T19:21:23Z")

</div>

Check out this example call that the WP plugin uses:

> <https://github.com/Patreon/patreon-wordpress/blob/1a2657091741136d7b4e407ad71064fec701a7a9/classes/patreon_api_v2.php#L22>

This should allow you to get whatever you need about your patron, by using the patron’s token.

If you arent having your users log into your website, then you will need to include the relevant fields as a relation through the member resource though.
