Give up one of the account's bought numbers. Its monthly charge stops; what was already paid is not refunded, and the number cannot be gotten back. The free number that came with the account cannot be released. Only do this when the user asks.

delete/api/numbers/{number}

Request

  • Base URL: https://call4.me
  • URL: https://call4.me/api/numbers/{number}
  • Auth: HTTP bearer

Path parameters

numberstring required

one of the account's numbers, e.g. "+31612345678"

E.164, URL-encoded (+ as %2B)

Response

The number released

numberstring required

formatted for people

e164string required
countrystring required

ISO 3166-1 alpha-2

country_namestring required
typestring required

local, mobile, national or toll_free

includedboolean required

the free number that came with the account

monthlystring required
monthly_centsinteger required
renewsstring nullable required

date the next monthly charge is due; null for the free number

overdueboolean required

the last renewal failed for lack of credits

release_afterstring nullable required

when an overdue number is released unless credits are added

Changes

No recorded changes to this operation across all 1 revision of this API.