Resolving Call Log and Call Usage Discrepancies
If you are comparing your call logs (through either your Console logs or the API /Calls List) against your call usage (through either the Console Usage page or the API Usage/Records) there are a number of considerations to keep in mind for a proper comparison.
Match Call Logs with Usage Logs
In order to match call logs with Usage API, keep these points in mind:
- The
count
in the usage API is the number of events (# of calls, in this case) - The
usage
returned via the Usage API is the total number of BILLED minutes per call, rounded to duration defined by the pricing model ( minimum and round quantity ) - In the
usage
console, call usage is displayed separately as "voice minutes" and "client minutes". Since client calls are a separate entity in the usage API definition, you will need to get the usage for calls and client calls separately. - Not all calls listed in call logs are billed. For example, calls with status :
Failed
, orBusy
, are not billed and the usage API will not add the usage from those calls. - Internally, the date parameter defaults to midnight. When querying the call logs for a month, use
< 1st day of next month
as the end boundary (do not use<= last day of this month
).
Rectify Billing and Call Logs
Parameter |
Usage (API and Console) |
Logs (API and Console) |
How to Reconcile Usage and Logs |
Duration of Calls |
Measured in minutes |
Measured in seconds |
Round up duration in your call logs to the nearest minute to match the usage logs. |
Voice vs. Client Calls |
Client and Voice calls are treated separately |
Client and Voice calls are merged |
Add your voice and client usage minutes together to match the combined logs. |
Call Billing Time |
The start date of the call is the date we use to attribute it |
N/A |
If a call begins in one month and ends in another, usage would be attributed to the first month.. |
Call Time Zone |
Calls timezone is always in UTC |
Calls will be in UTC or your local time zone |
If your logs are in your local time zone, normalize them to UTC to match usage. |
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.