To the best of my knowledge, we do not have any Phone Number events one can subscribe to. But what I would like to suggest is that you submit this idea to the RingCentral Ideas Portal so that we can route the idea to the right team to implement.

In the meantime, I want to make sure you are aware of this API call: https://developers.ringcentral.com/api-reference/Phone-Numbers/listAccountPhoneNumbers

This API will allow you to retrieve a list of all phone numbers in an account. Look at the `usageType` parameter. Unused numbers may be found with a usageType of `NumberPool`. Unfortunately, you cannot filter by this usage type (a separate idea you might want to submit to the ideas portal btw). But you could generate the full list of numbers, iterate over the list, and pluck out the unused ones.

In summary - currently, you will need to create your own logic for iterating over all phone numbers looking for unused ones.

---

Hey @Byrne Reese - We use the following endpoints extensively

1. ~/restapi/v1.0
2. ~/account/~/phone-number
3. ~restapi/v1.0/account/~/phone-number/$phnID
4. ~/restapi/v1.0/account/~/extension
5. ~/restapi/v1.0/account/~/extension/$extID/phone-number
6. ~/restapi/v2/accounts/~/phone-numbers

6 Supports: PATCH for assign/reassign phoneNumerID to/from extensionID |
Filter: ?usageType=Inventory

The Subscription (Webhook) we use is ~/api-reference/Extension-List-Event, which is supposed to send event notices for "phone numbers (assign/unassign)"

We are not seeing those event Hints in our Webhook receiver/endpoint. We are seeing the other events/notices listed for the method in the API Reference.

Should I submit a support ticket on this?

Thanks in advance!

---