Dynamic Number Intelligence (DNI) is Bandwidth’s package for advanced phone number data that offers a full suite of features, like carrier assignment for both voice and messaging, carrier deactivation reports, and the current observed activation status, all for one easy flat rate. It also includes Continuous Number Lookup (CNL) that provides the name of the carrier in the final message delivery webhook returned to you.
Common use cases
Pre-send validation: Strip non-textable numbers (landlines, deactivate) prior to campaign send.
Onboarding workflows: Confirm that a number is textable and active during user sign-up or MFA setup.
Send list hygiene: Run routine audits of your subscriber database to keep it clean (e.g., detect numbers that are likely to be reassigned and thus no longer opted in).
Carrier volume tracking: Identify which carriers your messages are going to, so you can better manage throughput limits and predict costs.
Deactivation monitoring: Detect deactivated or reassigned numbers before you send messages to them.
Activation status: View recent activation status on numbers, as seen on the Bandwidth’s network, so you can make confident send decisions.
Using DNI
DNI lets you choose from two API modes, depending on your workflow:
Synchronous: Submit up to 100 numbers, get results back immediately in the response. Ideal for real-time workflows like onboarding or MFA validation.
Bulk Asynchronous: Submit up to 15,000 numbers in a single request, poll for results. Designed for large batch processing like weekly or monthly list audits.
Note: See our dev docs for full endpoint details, request/response schemas, and code examples.
Bandwidth’s Phone Number Lookup API already provides compelling differentiation compared to rival solutions, including returning the message provider and voice provider independently as these are not always the same, and normalizing the provider name as each tier 1 carrier has hundreds of different names assigned against their numbering blocks.
In addition to the standard Phone Number Lookup data, DNI provides carrier-reported deactivation status, as well as active status, as observed on Bandwidth’s network. This combination of carrier-reported deactivation data and Bandwidth-observed messaging status offers meaningful insight into whether a number is genuinely out of service, temporarily suspended, or still active despite appearing on a deactivation list.
Field | Description |
deactivationReporter | The carrier that reported the number as deactivated within the last 45 days, if applicable. |
deactivationDate | When the event was reported |
deactivationEvent | SUSPEND, DEACTIVATED, or REACTIVATE* |
latestMessageDeliveryStatus | Bandwidth-observed messaging delivery status: ACTIVE, DEACTIVATED, or UNKNOWN |
initialMessageDeliveryStatusDate | First date Bandwidth observed the current delivery status for this number |
latestMessageDeliveryStatusDate | Most recent date Bandwidth observed the current delivery status |
*Only Verizon reports SUSPEND and REACTIVATE events. All other carriers are reported simply as DEACTIVATED.
Additional information
Available to all Bandwidth API customers, DNI is priced as a fixed monthly rate based on your messaging volume, which eliminates the per-lookup cost and makes frequent list validation economically viable. To enable DNI on your account, please contact your Bandwidth Account Manager. For full endpoint details, request/response schemas, and code examples, visit our dev docs.