Voice Billing Detail Records (BDRs) provide a detailed view of billable voice calls associated with your service account. There are two types of Voice BDRs reports:
The Voice BDRs report provides a detailed view of rated calls, inbound and outbound voice usage, along with the call details used to rate calls within the provided date range. The current service month's records should not be used for reconciliation as the rate and charges are considered estimates until finalized at the end of the service period. Additionally, any discounting you may have will not be reflected in the rates you see in the Billing Detail Records.
The Voice BDRs - Statement report provides a detailed view of rated calls, including inbound and outbound voice usage, along with the call details used to rate calls billed on the selected statement. It’s initially available at the beginning of the month, but may be revised until the final statement is delivered. Additionally, any discounting you may have will not be reflected in the rates you see in the Billing Detail Records.
Downloading Voice BDRs
Log in to the Bandwidth App.
In the side navigation bar, select Insights.
Select Reports and click Charges.
Under Type, select Voice.
Under Report name, select Voice BDRs or Voice BDRs - Statement.
For Voice BDRs, use the Call Date-start and Call Date-end fields to select the date range of the BDRs you want to download (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.
For Voice BDRs - Statement, use the Statement field to select the statement you want to download Voice BDRs for (up to 12 months back). Please note that the statement month corresponds to the prior service month. For example, Voice BDRs for the January 2026 statement will include all records from the December 2025 service month. Finalized reports will be available by the 7th day of the month.
Click Advanced Filters to filter your data by additional optional criteria:
Under Source Country, select a country or territory a call was placed from.
Use Destination Country, select a country or territory a call was placed to.
Click Download Report to begin processing. Once the Status column in the table displays Completed, click the icon in 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 BDRs field descriptions
The following table contains the descriptions and example values of the fields in the Voice BDRs and Voice BDRs - Statement reports.
Note: All times are in UTC (Coordinated Universal Time).
Field | Description | Example Value | Schema |
Account Number | Customer account number | 1234567 | Varchar(50) |
Call Start Date Time | Date/time the call started - UTC | 2024-07-16 01:34:46.000 | Timestamp (ISO 8601, No "T" Separator) |
Call End Date Time | Date/time the call ended - UTC | 2024-07-16 01:38:12.000 | Timestamp (ISO 8601, No "T" Separator) |
Product Name | Charge description as it appears on the invoice | International, Interstate, Origination - Tier 0 | Varchar(999) |
Call Source | "From" telephone number | +15555551234 | Varchar(32) |
Call Destination | "To" or dialed telephone number | +15555554321 | Varchar(32) |
Duration | Length of call in seconds | 198 | Numeric(19, 7) |
Per Min Rate | Per-minute rate in the customer contract | 0.0011100 | Numeric(19, 7) |
Amount | Total billed amount of the call (before taxes) | 0.0032210 | Numeric(19, 7) |
Source Country | Country of "from" number; 2-character abbreviation | US | Char(2) |
Destination Country | Country of “to” or dialed number; 2-character abbreviation | US | Char(2) |
Bdr ID | Call record identifier | 58337677151 | Varchar(128) |
Source IP | IP tied to the "from" number | 11.11.11.11 | Varchar(255) |
Destination IP | IP tied to the “to” or dialed number | 11.11.11.11 | Varchar(255) |
Rate Attempts | Number of times the call record has been rated | 1 | Tinyint |
Unique Record ID | Unique Record ID defined in the Call Detail Record (CDR); can be used to relate the BDR report to the CDR report | a7109fb69fb83a00accce098 0f1aaa0ebxwmz6alaoqd628 | Varchar(128) |
LRN* | Location Routing Number associated with the dialed number | +15555554320, empty | Varchar(32) |
Source State* | State/province of "from" number; 2-character abbreviation | NC, empty | Char(2) |
Source LATA* | LATA of "from" number | 426, empty | Int |
Source Rate Center* | Rate Center of "from" number | NC_RALEIGH, empty | Varchar(50) |
Destination State* | State/province of dialed number; 2-character abbreviation | LA, empty | Char(2) |
Destination LATA* | LATA of dialed number | 490 | Int |
Destination Rate Center* | Rate Center of dialed number | LA_NEWORLEANS, empty | Varchar(50) |
Location ID | Customer Location ID in the Bandwidth App | 12345 | Varchar(50) |
Location Name | Customer Location name in the Bandwidth App | ABCD | Varchar(100) |
Sub-account ID | Customer Sub-account ID in the Bandwidth App | 1234567 | Varchar(50) |
Sub-account Name | Customer Sub-account name in the Bandwidth App | ABCD | Varchar(100) |
Statement Date** | Statement date that the BDRs were billed | 2024-08-07 | Date (ISO 8601) |
* Provided for North American Numbering Plan Administrator (NANPA) calls only. Will be empty for non-NANPA calls (e.g, European calls).
** Only included in the Voice BDRs - Statement report.
Voice BDRs field comparison
As part of our goal to make Bandwidth reporting tools simpler and easier to use, we retired the legacy Voice BDR and Voice Statement BDR reports on February 1, 2026. The following table shows how the new BDR fields compare to their legacy versions.
Legacy BDR Field | New BDR Field |
AccountNumber | Account Number |
CallStartDateTime | Call Start Date Time |
CallEndDateTime | Call End Date Time |
CallType | Product Name* |
CallSource | Call Source |
CallDestination | Call Destination |
Duration | Duration |
PerMinRate | Per Min Rate |
Amount | Amount |
TierType | Removed due to overlap with Product Name |
SourceCountry | Source Country |
DestinationCountry | Destination Country |
CallID | Removed due to overlap with Bdr ID |
BdrID | Bdr ID |
SourceIP | Source IP |
DestinationIP | Destination IP |
RateAttempts | Rate Attempts |
Unique Record ID is a new field | Unique Record ID |
LRN | LRN |
SourceState | Source State |
SourceLATA | Source LATA |
SourceRateCenter | Source Rate Center |
DestinationState | Destination State |
DestinationLATA | Destination LATA |
DesinationRateCenter | Destination Rate Center |
CallID | Removed due to overlap with Bdr ID |
LocationID | Location ID |
LocationName | Location Name |
SubAccountID | Sub-account ID |
SubAccountName | Sub-account Name |
Statement Date is a new field | Statement Date |
* Product Name encompasses the CallType and TierType information (this is mostly relevant for Origination), and will match the invoice line item name.