To ensure compliance with FCC guidelines and standards in the U.S., it’s very important that anyone sending messages to end users regularly removes any disconnected members from their subscriber list. To do so, we can provide you with an aggregated list of disconnected MDNs for U.S. carriers.

❗
Why do I need carrier disconnect files?
If you or your clients maintain a subscriber list that you message on a regular basis, this is required by law. Deactivation file information is to be used solely for this purpose. It is not appropriate to share or utilize this data in any other manner, including commercial purposes.

File Definitions

We generate the disconnect files daily, and the file is made available at the end of each day (Central Time). Since the file is made available at the end of the day, for scripting purposes, your script should run at the beginning of each day (CT) and retrieve the file from the previous day.

There are two different versions of the file for the 10-digit US format and International MDN format, which are identical except for the format of the MDN in the file. The international format has the +<country> identifier, which is always +1 for US MDNs. The original disconnect file format includes the MDN with the +1 omitted.

The file format for both files is a TAB delimited file, no quoted strings, with the following columns:

Column	Sample Data	Comments
MDN	International: +18475551212 Domestic: 8475551212	The format varies based on the disconnect file retrieved.
Carrier Code	104	See Carrier Codes for the complete list of valid Carrier Codes.

File Names

All disconnect files follow a standard naming convention which include the date the file was generated. They are gzip'd .tsv files. The file names are:

Format	File Name	Example file (for September 1, 2013)
International	disconnect_intl_YYYY_MM_DD.tsv.gz	disconnect_intl_2013_09_01.tsv.gz
Domestic	disconnect_YYYY_MM_DD.tsv.gz	disconnect_2013_09_01.tsv.gz

File URL and Access

All files are accessible at the following URL:

https://disconnects.vibesapps.com/disconnects/<file>

where <file> is the specific disconnect file that is being retrieved. The files are restricted by IP address, so you'll need to provide your originating IP addresses in order to access the file.