REST API

To communicate to the web service you will need to request the following URL as a web service URL using your programming language.

API URL: https://avidtrak.com/webservice/api.php

Web Service Type: REST

Required Parameters for all actions:

• pincode: pincode for authentication purpose
• method: data to be pulled for
• format: json or xml

Example URL https://avidtrak.com/webservice/api.php?pincode=YOUR_PIN_CODE&format=xml&method=search_number

How to Get Pincode for Agency

• Login to AvidTrak interface at https://avidtrak.com/accounts
• Navigate to “Settings" page and click “Generate New PIN"
• A new Pincode will be generated and shown with the generate button as shown in image below

How to Get Pincode for Client

For Agency Client

• Navigate through "API" under agency area
• Select client for you wish to generate Pincode
• Click "Generate Pin" to generate new Pincode as shown in image below

For Individual Client

• Navigate to "My Accounts" -> "My Account Settings"
• Click "Show/Hide" button to show advance settings
• Open "Generate APIPin" area and click "Regenerate Pin" to generate new Pincode as shown below

Response:

Following is the response upon successful query.

Following is the response if an error is produced from the server

Response Codes and Status

Methods:

This method is used to create new client account under agency

Method name: create_account

Responses

You might get different responses as shared below.
Upon finding that the UserID already exist you will get the response:-

Upon a successful account creation the response will be:-

Update User Detail:

This method is used modify user details like changing User ID or password contact name and email for agency or client

Method name: update_user_details

Upon a successful data update you will get the response:-

If a UserID already exist the response will be:-

Search and Purchase Number

Purchase number is divided in two methods. First you will search for numbers you want to purchase for your call tracking, it will give the available numbers according to your criteria. Then you will select and provide the number to another function from the available numbers for the final purchase.

Method name: search_number

The Successful response of method search_number will be:-

Method name: purchase_number

In case you have no balance or fewer amounts then the purchase_number response will be:-

Upon a successful number purchase the response will be:-

This method will transfer numbers, with the given SIDs, to the Client Account selected by the agency using “client_pin” parameter.

Method name: transfer_number

Upon a successful number transfer you will get the response:-

After purchasing a number you have to assign it a marketing channel in case of an online dynamically inserted number or as static (LITE) in case of an offline number. This method will assign a search engine to the given SID.

Method name: assign_number

Upon a successful number assignment you will get the response:-

This method will list the numbers under client

Method name: list_numbers

Upon a successful number listing you will get the response:-

This method will change the receiving number against the provided phone number SID or by type. The phone number SID is available from “list_number" method against each of your numbers.

Method name: set_forwarding

The response of a set forwarding method will be :-

This method will remove the receiving number against the provided phone number SID or by type. The phone number SID is available from “list_number" method against each of your numbers.

Method name: remove_forwarding

Upon a successful forwarding removal you will get the response:-

Round Robin call forwarding allows you to sequentially forward an incoming call to different receiving numbers. In this method the system forwards the call first to your default receiving number and if the call is not answered by the default number, after a set number of rings the call is forwarded to the next receiving number on the list.

Method name: insert_round_robin

Upon adding a successful round robin setting you will get the response:-

This method will list round robin settings of provided number SID. The phone number SID is available from "list_number" method against each of your numbers.

Method name: list_round_robin

Round robin list response will be:-

This method will update round robin settings of provided number SID. The phone number SID is available from “list_number" method against each of your numbers and “round_robin_list_id" is available from “list_round_robin" method against each of SID parameter.

Method name:edit_round_robin

Upon editing Round robin the response will be:-

This method will delete round robin settings of provided number SID. The phone number SID is available from "list_number" method against each of your numbers and “round_robin_list_id" is available from “list_round_robin" method against each of SID parameter.

Method name:delete_round_robin

Upon deleting Round robin the response will be:-

This method will change the extra settings for your phone numbers like
caller greeting, whisper message, call recording

Method name:update_number_setting

Update number settings response will be:-

This method will create a new offline campaign for the given phone number.

Method name:add_lite_campaign

This method will provide all offline active campaign details with the number of calls.

Method name:lite_campaign

The offline campaigns response will be:-

This method will provide all the offline campaign calls.

Method name:all_lite_calls

The response will be:-

This method will provide call data

Method name:call_logs

The response will be:-

This method will provide the pincodes against each client username for an agency. This method will only work if the agency pincode is used

Method name:client_list

No Parameters except required one mention in page 4.

The response will be:-

This method will provide remaining balance against the pincode.

Method name:get_remaining_balance

No Parameters except required one mention in page 4.

The response will be:-

This method will return numbers to Agency Account and/or Delete Permanently by returning to the Telephone Company (telco) for the given phone number SID.

Method name:return_number

The response will be:-

This method will provide Visit data by keyword.

Method name:visit_data

The response will be:-

This method will add or delete to the AvidTrak SMART REPLACE manifest of website telephone numbers that you wish to target for dynamic swap with AvidTrak call tracking number(s).

Method name:set_smart_replacement

Upon adding the smart replacement number the response will be:-

Upon deleting the smart replacement number the response will be:-

This method will add the website phone number of a specific company based on a Metropolitan “Metro” page which is to be targeted for a dynamic swap and replaced by a call tracking tracking number assigned to it.

Method name:add_metro_site_number

The response will be:-

This method provides a manifest of all targeted website Swap numbers, any names thereof of targeted swap numbers; along with the tracking numbers associated with the targeted swap number.

Method name:list_metro_numbers

None

The response will be:-

This method will allocate tracking number(s) to metro site number. You will need to provide tracking number SIDs. You can find the SID by using list_numbers method and site id that you can get through the list_metro_numbers method

Method name:add_metro_site_number

None

The response will be:-

This method will remove metro site number along with the phone number allocation. This method also changes the forwarding of the allocated number of provided site id to the default forwarding number.

Method name:remove_metro_site_number

None

The response will be:-