Release a Phone Number From Your Account

Releases the specified phone number from your account. Upon release, Flowroute will stop billing you for the monthly phone number fee, and add the phone number back into the purchasable numbers inventory. If you make a mistake, please contact Support.


DELETE /numbers/:id

Path Parameters

  • id
    integer required

    Phone number to be released from your account. The number must be in 11-digit E.164 format with the first digit being the country code 1; e.g. 12061231234.

Response Fields

On success, the HTTP status code in the response header is 204 No Content which means that the server successfully processed the request and is not returning any content. On error, the header status code is an error code and the response body contains an array of error objects.

Example Request

DELETE /v2/numbers/12064621860 HTTP/1.1
Accept: Accept: */*


Example Request

curl -X DELETE -H "accept: */*" -u accessKey:secretKey


Example Responses



  "errors": [
      "detail": "Could not find that resource on your account.",
      "id": "d66802f3-b56b-43da-8c55-e8c9ec3e0a6d",
      "status": 404