Configure the callback URL to notify when a call dialing record is available.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Set CDR callback to receive Call Records at the end of every calls to or from fonenumbers in your account.
Notes
account_id
account_id10 digit account code
method
method This parameter specifies the methods used for the callback and its data.
GETreturns data through query string parameters on a GET to the given URL.POSTreturns data through query string parameters on a POST to the given URL, with a full set of data in a JSON-encoded structure in the body. The request will have a header of application/x-www-form-urlencodedJSONreturns data through query string parameters on a POST to the given URL, with a full set of data in a JSON-encoded structure in the body. The request will have a header of application/json
url
url The url parameter contains the URL to be called when the event takes place. The full URL, including the protocol (https://) needs to be provided (URLs with valid SSL certificates are supported only.).
username and password
username and passwordCallbacks support optional HTTP Basic authentication. If the username and password parameters are provided, the corresponding authentication headers will be included in callback execution.
For more information, see Callbacks / Web Hooks.
Note• You may get multiple callbacks for the same call from our side. Always keep the highest "bill_amount" callback out of them.
Callback Properties
| Property | Type | Description |
|---|---|---|
| account_code | String | Account Code |
| allow_surcharge | String | "yes" or "no" |
| bill_amount | String | Bill amount of the Call |
| bill_rating | String | Bill Rating |
| billable_minutes | String | Billable minutes |
| billable_seconds | String | Billable seconds |
| billing_increment | String | Billing increment |
| call_date | String | Date of the call |
| call_duration | String | Call duration in seconds |
| call_type | String | "INBOUND" or "OUTBOUND" |
| caller_id | String | Caller ID name or number |
| caller_id_number | String | Caller ID number |
| customer_ip_address | String | IP address of customer |
| device_username | String | Device ID of the device connected |
| dialed_number | String | Dialed number |
| dialed_number_lrn | String | LRN of dialed number |
| disposition | String | Disposition of the call. Ex - ANSWERED, REJECTED, etc. |
| sip_cause | String | SIP cause for call termination |
| hangup_cause | String | Hangup cause for call termination |
| id | String | ID of the call |
| jurisdiction | String | Juridiction |
| jurisdiction_number | String | Juridiction number |
| long_distance_access_code | String | Long distance access code |
| packet_loss | String | Packet loss during the call |
| post_dial_delay | String | Post dial delay |
| per_minute_rate | String | Per minute rate |
| recording_url | String | URL of call recording |
| surcharge_amount | String | Surcharge amount |
| surcharge_rate | String | Surcharge rate |
| ama | String | AMA |
Response Properties
| Property | Type | Description |
|---|---|---|
| account | object | Account |