Manage number pools

Number pools are managed groups of numbers that you can reserve for certain uses, for example particular customer groups or subscriptions. A number pool defines the number range(s) the pool includes and duration settings for allocation and quarantine of a number.

A number in a pool has four allocation statuses:
  • temporary—the number has been selected and cannot be selected elsewhere, but is not allocated until the selection has been saved.
  • pre-allocation—the number has been allocated, but is not yet active or in use. The number cannot be allocated elsewhere.
  • allocated—the number is in use and cannot be allocated elsewhere.
  • quarantine—the number is no longer in use, but cannot be re-allocated until it has been released.

Methods that manage number pools are located on the pool endpoint. The pool WSDL is located at http://smile.example.com:port/stage/smile/ws/v2/pool?wsdl

The following methods manage number pools:
  • search() performs a search for reservable resources across a pool.
  • getLink() retrieves the details of a link by ID.
  • createReservation() reserves a range of resources from the pool specified, and creates an initial link to the range.
  • createLinkToReservation() adds a link to an existing reservation.
  • unlink() reserves a range of resources from the pool specified, and creates an initial link to the range.