Skip to main content

Delete purchased 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

When to use:

  • User wants to cancel number purchase
  • Returning numbers after unsuccessful activation
  • Bulk number release

Authentication:

  • Requires Bearer token in Authorization header: Authorization: Bearer <token>

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.

Request​

Responses​

cancels owned numbers and reports skipped ones as warnings