v4
latestOpenAPI 3.1.02026-08-0255174167.5 KBphoneNumbers
Release a phone number
Release a number — standard SMS/call or iMessage. Immediate and irreversible.
On a flat-rate subscription, releasing a number lowers the subscription quantity by one and Stripe prorates the change — but the quantity never falls below one number. Releasing your last number therefore leaves the subscription active at the single-number rate rather than cancelling it, and the next number you provision is free (see Provision a phone number). To stop paying entirely, cancel the subscription with Cancel the subscription at period end.
delete/api/v1/numbers/{id}
Path parameters
idstring required
Headers
Authorizationstring required
Your Dial API key, sent as Authorization: Bearer sk_live_...
Response
Released.