What are Voice Call Detail Records?
Voice Call Detail Records (CDRs) provide a detailed view of voice calls associated with your service account. You can use CDRs to evaluate your traffic usage.
How do I download Voice CDRs?
Log in to the Bandwidth App.
In the side navigation bar, select Insights.
Select Reports and click Usage.
Under Type, select Voice.
Under Report name, select Call Detail Records (CDRs).
Use Call Start Time-start and Call Start Time-end to define the date range of the CDRs you want to download (you can set the Call Start Time-start date up to 12 months back. For the current month, you can download all available records month-to-date. Please note that data may be delayed by a few hours.
Under Region, select whether you want to download the data for the US or the EU.
Click Advanced Filters to filter your data by additional optional criteria:
Use Source Country to filter by the country or territory the call was placed from.
Use Destination Country to filter by the country or territory the call was placed to.
Use Direction to filter by the direction of the call.
Use Response Code to filter by SIP Response Codes.
Use Hangup Source to filter by the source of the hangup.
Use Attestation to filter by STIR/SHAKEN attestation levels.
Click Download Report to begin processing. Once the Status column in the table below shows Completed, click the icon under the Actions column to download the CSV copy of the report (it will be available for 5 days). All reports for this category from the last 30 days will also appear here.
Voice CDR report field descriptions
The following table contains the descriptions and example values of the fields in the Voice CDRs report.
Note: All times are in UTC (Coordinated Universal Time).
Field | Description | Example Value |
Customer ID | Customer account number; Insights API description – CRM ID of the account to get calls from | 1234567 |
Unique Record ID | Voice-assigned Unique Record ID; this is also used in BDR reports | a7109fb69fb83a00accce0980f1aaa0ebxwmz6alaoqd628 |
Call ID | Unique Call ID | |
Call Start Time | Date/time the call started in UTC | 2024-07-16 01:34:46.000 |
Duration | Length of call in seconds | 198 |
Response Code | SIP Response Code | 200 |
Result | Call completion indication | completed, incomplete |
Call Destination | The called party’s phone number in the E.164 format | +15555551234 |
Destination Country | Country of the called party | US |
Call Source | The calling party’s phone number in the E.164 format | +15555554321 |
Source Country | Country of the calling party | US |
Direction | Inbound or outbound call | Inbound, outbound |
Hangup Source | The party that hung up | CALLING_PARTY, CALLED_PARTY, INTERNAL |
Attestation | STIR/SHAKEN attestation level | A, B, C |
Post Dial Delay | PDD in milliseconds | 10 |
Packets Sent | Number of audio packets sent | 256 |
Packets Received | Number of audio packets received | 354 |