Returning Numbers

When numbers are no longer required there are 2 methods that can be used to disconnect the numbers. Either through the Portal or through the API. Once a number is disconnected it will be returned to cloudnumbering and no longer appear on your account for use, we will also cease all billing for that number. 

Portal

In the Portal select the Number Inventory option under Number Management.

From here select a number you wish to disconnect and select the Disconnect Number option. 

Once selected a confirmation box will appear where the disconnection should be confirmed and the number will be returned to cloudnumbering.

API

The API allows for a programmatic interface to deleting numbers which can provide some more flexibility when disconnecting larger amount in one go.

The following link will direct you to the API endpoint. The endpoint requires that the number sid is used when disconnecting numbers. The sid for each number can be found by using the list numbers endpoint, or list numbers for an order endpoint.

Disconnect a number

When listing out the numbers you will need the sid starting with "AN". For example, from the list numbers endpoint:

{
"sid": "AN08E6602B57AE417F9EBBC5164AEC1CE8", <---- This sid is required for disconnect.
"numberSid": "NB29C74B6AFADF4E45920000F5DA908FFA",
"numberGroupSid": "NGC41E6691E70A4A88B8A8319EE439D763",
"countryIso": "GB",
"number": "+447777123123",
"voiceEndpointSid": "EP645D355F2D16434FA3515662D1CA41B7",
"voiceEndpointName": "Test",
"smsEndpointSid": "EP147921EB9AC24328ABB0A708991310BC",
"smsEndpointName": "SMS Test",
"nextBillingDate": "2025-04-17T00:00:00.000Z",
"numberRental": 0.5
},