Knowladge Base

1D GET A LIST OF AVAILABLE Rated DIDs

This method returns the list of available DID’s by Vendor Rating in the form of an array. The user is required to give User Id, Password, Country code, Area code and Vendor Rating as arguments and he’ll get a list of available DID’s for the area of the country for which he’s provided the code. If the user wants available DID’s for the whole country and not just for a particular area, then he should supply only Country code (e.g., “44” for UK). If he wants DID’s for just one particular area, he should supply Country code with Area Code (DID Prefix, e.g., “4420” for UK, London). In return, he’ll get the list of available DID’s for desired area. Please note user must supply area code for US. ( e.g., “1567”) User can supply Vendor Rating range to get a list of available DID’s by Vendor Rating Rating. If there is no range is defined, then it will get a list of DIDs with all vendor ratings. (limited display)

 

Example URL:

http://newapi.didx.net/DidxApis/api/getAvailableRatedDIDSbyCountryCode.php?UserID=700290&Password=XXXX&CountryCode=1&AreaCode=570

 

Example Code in PHP:

<?php

$curl_handle = curl_init();

$url = "http://newapi.didx.net/DidxApis/api/getAvailableRatedDIDSbyCountryCode.php?UserID=700290&Password=XXXX&CountryCode=1&AreaCode=570";

curl_setopt($curl_handle, CURLOPT_URL, $url);

curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, true);

$curl_data = curl_exec($curl_handle);

curl_close($curl_handle);

$response_data = json_decode($curl_data);

echo('<pre>' . print_r($response_data, true) . '</pre>');

die();

?>

 

Input Fields:

    1. *UserID
    2. *Password
    3. *CountryCode
    4. AreaCode
    5. Prefix
    6. VRatingFrom
    7. VRatingTo
    8. Limit
    9. VendorsList(Comma Separated)
    10. RateFrom
    11. RateTo
    12. CountryID

 

Returned Fields:

    1. DIDNumber
    2. OurSetupCost
    3. OurMonthlyCharges
    4. OurPerMinuteCharges
    5. Country
    6. Area
    7. CountryCode
    8. AreaCode
    9. StateCode
    10. VendorID
    11. RateCenter
    12. DIDID
    13. HideNumber
    14. CountryID
    15. SMSEnable
    16. VoiceEnable
    17. VanityRating
    18. FreeMinutes
    19. IncludedChannels (Note: If channel based then return number of channels else return -1)

 

Error Codes:

In case of any incorrect information provided by the user or in case of no matching data, an error code will be returned. Error codes correspond to the following messages:

-1 = User ID does not exist

-2 = Your Password is Incorrect

-3 = There are no rated DID’s for this Area in our record.

-10 = There is no area code defined with US Country code.

-11 = Country code not provided.

-12 = Invalid Price Range

-100 = Nothing available