Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Phone Numbers

Delete Numbers from Inventory

This method can only delete numbers that meet one of the following requirements:

  • numbers that have "usageType": "Inventory"
  • "Forwarded" numbers
  • "Forwarded Company" numbers

In other words, this method will not delete numbers which are in use on the account - extension direct numbers, main number, etc. It is possible to indicate phone numbers to be deleted using their IDs or exact string values in e.164 format. However, the same lookup method (by ID or by value) must be used for all numbers within the same API call.

delete/restapi/v2/accounts/{accountId}/phone-numbers

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

Request body

Example request

{
  "records": [
    {
      "id": "1162820004",
      "phoneNumber": "+16501234567"
    }
  ]
}

Response

Successful response

Example response

{
  "records": [
    {
      "bulkItemSuccessful": true,
      "bulkItemErrors": [
        {
          "errorCode": "XXX-123",
          "message": "Something went wrong"
        }
      ],
      "id": "1162820004",
      "phoneNumber": "+16501234567"
    }
  ]
}