Supported in Sandbox
All methods require, at the very least, two parameters – Login and Password. These will be the first two parameters of every method call. Login/Password credentials can be managed in the Back Office at Add-Ons -> API Users. All methods will return a response object.
Supported in Sandbox
3.1 auditDIDs
3.2 queryDID
3.3 assignDID
3.4 getDIDs
3.5 configDID
3.6 releaseDID
3.7 reserveDID
3.8 isPortable
3.9 getDIDCount
3.10 getPortDetails
3.1 auditDIDs Top
This method returns all DIDs that the client currently owns, as well as key information regarding each of those DIDs.
Parameters:
...
Returns: DIDResponse
Properties populated: responseCode, responseMessage, DIDs, ConferenceLine
3.2 queryDID Top
This method returns key information regarding the DID being queried. If the DID is owned by the client, the function will return various parameters pertaining to the DID. If the DID is available to purchase or not available, the function will return such information instead.
Parameters:
...
Returns: DIDResponse
Properties populated: responseCode, responseMessage, DIDs, ConferenceLine, (a dummy record with a "no records found" status will be returned if no records are found)
3.3 assignDID Top
This method assigns an available or reserved DID to a valid endpoint group on your account.
Parameters:
...
Returns: DIDResponse
Properties populated: responseCode, responseMessage, DIDs (one DID per param), ConferenceLine
3.4 getDIDs Top
This method allows the user to search the inventory of available DIDs by one or more, and returns all DIDs that meet the desired criteria. At least one search criteria must be passed. Pass an empty String or null for criteria not being searched on.
Parameters: At least one search criterion must be provided. However, we recommend passing as many fields as possible to reduce the search time.
...
Returns: DIDresponse
Properties populated: responseCode, responseMessage, DIDLocators, ConferenceLine
3.5 configDID Top
This method configures the endpoint group and cnam for DIDs which are assigned to your account.
Parameters:
...
Returns: DIDResponse
Properties populated: responseCode, responseMessage, DIDs (one DID per param), ConferenceLine
3.6 releaseDID Top
This method is used to release DIDs from an account Parameters:
Name | Type | Description | |
login | String | Your API username | |
secret | String | Your API user password | |
DIDParam | List | Each DIDParam represents a DID to assign. The tn property is required. Optional | |
properties are cnam and refid. | |||
Returns: DIDResponse | |||
Properties populated: responseCode, responseMessage, DIDs (one DID per param), ConferenceLine |
3.7 reserveDID Top
This method will reserve an available DID for a maximum of 30 minutes. If the reserved DID is not assigned before the time expires, it will be released back into inventory.
Name
...
Properties populated: responseCode, responseMessage, DIDs (one DID per param), ConferenceLine
3.8 isPortable Top
This method allows the user to determine if a telephone number is portable.
Parameters:
...
Returns: PortResponse
Properties populated: responseCode, responseMessage, IsPortable
3.9 getDIDCount Top
This method allows the user to search the inventory of available DIDs by one or more, and returns the number of DIDs available at each rate center per ties. At least one search criteria must be passed. Pass an empty String or null for criteria not being searched on.
Parameters:
...
Returns: DIDResponse
Properties populated: responseCode, responseMessage, DIDCount, ConferenceLine
3.10 getPortDetails Top
Returns the details of a specified port ID.
Parameters:
...