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 + 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://messageapi.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.