Operations for buying and configuring numbers and keywords.
Use a know subset of info on a region to query for the full set of info on a region.
Example, if you know the city you can query for phone number prefixes, rate-centers,
etc... associated with that city.
Search for numbers already purchased and in your account by region info
such as prefix, city, state, zipcode, rate center, etc... Returns info
on the numbers in your account such as status, lease info, configuration, etc...
Select number, using 11 digit E.164 format, already purchased and in your account.
Returns info on the number in your account such as status, lease info, configuration, etc...
Update number configuration, such as ENABLE / DISABLE or turn call recording on, using
11 diget E.164 format to select number. No response is returned.
Find numbers available for purchase using either TollFree = true or by
region info, such as prefix, city, zipcode, etc... The max count of numbers
to return must also be specified.
Get info such as status, lease dates, etc... on keywords owned by your account.
Supply list of keywords to see if they are available for purchase. If
keyword is available for purchase it will be returned in result. If not
available then it will not be returned in result.
Once available keywords are found they can be purchase using
Purchase numbers and keywords by creating a number order that includes a
list of numbers, list of keywords, region info, or specifying toll-free.
OrderId is returned from request.
Creating a number order is an asynchronous process. The returned orderId
can be used in a
GetNumberOrder request to see the status of
the order. However, there is no guarantee the order will be finished by
GetNumberOrder is called therefore the
operation must be polled (no more than once a second) untill the order is in a
terminal state (FINISHED or ERRORED).
The recommended way to determine if an order is finished is not to poll but to use a
SubscriptionService for information on registering a postback using
Returns information on the order status, cost, and assets aquired.
CreateNumberOrder is an asynchronous process this
GetNumberOrder operation may need to be polled for up to
20 seconds at a rate of no more than once a second to determine when the
order is in a terminal state of FINISHED or ERRORED. Order will be in
'PROCESSING' status untill finished.
CallFire's system automatically "renews" your numbers and keywords each month and bills you accordingly.
When you no longer need a number or keyword, you can easily 'Release' it and stop your recurring monthly charge.
Once you release a keyword, you will not be able to repurchase it for a month after the release becomes effective.
For example, if your keyword is slated to auto-renew for another month on April 29th, and you release it on April 15th,
you will still be able to use it until April 29th. However, you will not be able to repurchase it until May 29th.
Therefore, please be sure of your decision before releasing.