# GET /api/role/list

**URL:** <https://developer.sailpoint.com/discuss/t/get-api-role-list/8885>\
**Category:** Non-Public API Deprecations\
**Tags:** deprecated\
**Created:** [March 2, 2023, 10:04pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885 "2023-03-02T22:04:25Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\
**Post date:** [March 2, 2023, 10:04pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885/1 "2023-03-02T22:04:25Z")

</div>

Replaced by

> **[list-roles | SailPoint Developer Community](https://developer.sailpoint.com/docs/api/v3/list-roles)**
>
> List Roles

To see which identities are assigned a particular role, use [get-role-assigned-identities | SailPoint Developer Community](https://developer.sailpoint.com/docs/api/v3/get-role-assigned-identities). If you need a total count of identities assigned to a given role, you can use the query parameter `count=true`. If _true_ it will populate the _X-Total-Count_ response header with the number of results that would be returned if _limit_ and _offset_ were ignored.

---

<div class="post-metadata">

**Author:** ![gsanr](https://avatars.discourse-cdn.com/v4/letter/g/ed655f/32.png) [@gsanr](https://developer.sailpoint.com/discuss/u/gsanr)\
**Post date:** [March 21, 2024, 8:39pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885/2 "2024-03-21T20:39:55Z")

</div>

Hi Colin,

This v3 endpoint does not return the number of identities associated to the role, we do not get it either fetching role by role.

I see that the UI uses POST /beta/roles/count-assigned-identities, that is not so convenient since it has to be a second call, but we could make it work, however that call is not documented.

Could you provide the documentation of /beta/roles/count-assigned-identities or even better if you can get the count of identities added tot he this endpoint.

Thanks,  
Gustavo

---

<div class="post-metadata">

**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\
**Post date:** [March 21, 2024, 8:46pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885/3 "2024-03-21T20:46:44Z")

</div>

Hi Gustavo. Please see the first post, which I have updated with information on how to get identities assigned to a role.

---

<div class="post-metadata">

**Author:** ![gsanr](https://avatars.discourse-cdn.com/v4/letter/g/ed655f/32.png) [@gsanr](https://developer.sailpoint.com/discuss/u/gsanr)\
**Post date:** [March 21, 2024, 8:56pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885/4 "2024-03-21T20:56:02Z")

</div>

Yes, I saw that, but using it would mean me making 800+ calls to get those numbers (we have 800+ roles and increasing) instead of using just one call.

---

<div class="post-metadata">

**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\
**Post date:** [March 21, 2024, 11:29pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885/5 "2024-03-21T23:29:15Z")

</div>

Unfortunately, there is not enough time to make the suggested enhancements before the API is turned off. However, you can submit an idea to [ideas.sailpoint.com](http://ideas.sailpoint.com) to request this functionality.

---

<div class="post-metadata">

**Author:** ![gsanr](https://avatars.discourse-cdn.com/v4/letter/g/ed655f/32.png) [@gsanr](https://developer.sailpoint.com/discuss/u/gsanr)\
**Post date:** [March 21, 2024, 11:32pm UTC](https://developer.sailpoint.com/discuss/t/get-api-role-list/8885/6 "2024-03-21T23:32:02Z")

</div>

I will do, but at the speed the ideas are done, it will be at least 1.5 years before is even looked at (not exaggerating the time frame is based on previous ideas being evaluated).

I guess in the mean time I’ll do all the calls I have to … I hope IDN does not start giving 504s
