Release DID

This request releases a DID, targeted by secure ID, from the partner account. The DID status changes from assigned to 'aging'.

delete

/phonenumber/dids/{did_sid}

note

The same DID cannot be immediately rented again. To recover a released phone number, contact technical support at support@carrierx.com.

Sample

A sample DELETE request to release a DID, targeted by secure ID, from the partner account:

curl -X DELETE \
'https://api.carrierx.com/core/v2/phonenumber/dids/e8df62d5-07a3-4189-a67e-87585067c5fe' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'

Response

204 status code with an empty body.

Required Scopes

To release a DID object, the partner must have one of the following scopes enabled:

• phonenumber.manage
• phonenumber.delete

Path Arguments

Parameter	Data Type	Description
did_sid required	string	The secure ID of the DID.