Knowladge Base


This web service can be used to place back orders for DIDs you need. This service has 3 methods.

Method Signature

1. Get a list of countries which you can order.

Method: GetCountriesForBackOrder($UserID,$Pass)

2. Get a list of Areas you can order by country code.

Method: GetAreasForBackOrder($UserID,$Pass,$CountryCode,$Page)

2. Place Back Order for the DIDs you need.

Method: PlaceBackOrder($UserID,$Pass,$BackOrderList_ID,$Quantity,$UserData,$NotifyURL)

$UserID – $Pass : DIDx User ID and Password

$CountryCode – Country code to back order, which comes from method “GetCountriesForBackOrder” .

$Page – Each page returns a block of 100 areas in GetAreasForBackOrder(), starting from page 1.

$BackOrderList_ID – This ID will come from the method “GetAreasForBackOrder”

$Quantity – Quantity of DIDs you need.
$UserData – user provided value, which will return to notify URL.
$NotifyURL – Notification will be sent to this URL vi HTTP, when the back order will be completed.

Return variable:
1. ReturnValue? – contains User data.
2. DID – DID number which is being added to account as back order
3. Qty – Total quantity of DIDs in complete back order.

Note: Each notification contains one DID only.

Return Values

-1 – Invalid UserID/Password
-2 – Account is not Active
-3 – Invalid account type.
-4 – Invalid quantity provided.
-5 – Insufficient funds to place back order.
1 – Successfully placed back order.

Example :

On return, the method will provide an array of CountryCode and CountryName

For Method GetAreasForBackOrder

On return the method will provide an array of AreaCode,AreaName,NXX,RateCenter,VendorID,BackOrder_ID

Each query to get the areas, will return 100 areas. You need to provide the page no. for each block.

For Method PlaceBackOrder