Skip to main content

Release numbers

DELETE 

/api/v2/numbers/purchase

Cancel purchase of DID numbers and return them to inventory.

Important notes:

  • Can cancel multiple numbers in a single request
  • Numbers are returned to seller's inventory
  • Optional quarantine period before number becomes available again
  • Refund policy depends on service terms
  • A number still inside its commitment term is charged the early-return fee for the remaining months, the same fee as in the portal

Partial cancellation: Numbers not present in your cancelable inventory are skipped (not cancelled) and reported in the warnings array with code not_in_inventory. If none of the requested numbers are cancelable, the request returns 422.

A number that is cancelable but whose cancellation fails is reported with code cancellation_failed and is omitted from dids; it remains in your inventory and is still billable. A request where every number fails this way returns 200 with an empty dids array.

A number whose early-return fee your balance does not cover is not cancelled and not charged. It is reported with code insufficient_funds, is omitted from dids, and remains in your inventory.

Request​

Responses​

cancels owned numbers and reports skipped ones as warnings