Skip to end of metadata
Go to start of metadata

Last Updated: Wednesday, February 6, 2019



Vibes provides an aggregated list of disconnected Mobile Directory Numbers (MDNs) for US carriers. For customers that maintain a Subscriber List that they message to on a regular basis, customers must ensure that they regularly retrieve and remove any Subscribers that are on the carrier disconnect lists to ensure compliance with FCC TCPA guidelines, CTIA standards and carrier mandate. 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

Vibes generates the disconnect files on a daily basis, 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, at the beginning of each day (Central time) the script should 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:

ColumnSample DataComments
MDN

International: +18475551212

Domestic: 8475551212

The format varies based on the disconnect file retrieved.
Carrier Code104See Vibes Carrier Codes page for the complete list of valid Carrier Codes.

File Names

All of the 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:

FormatFilenameExample file (for September 1, 2013)
Internationaldisconnect_intl_YYYY_MM_DD.tsv.gzdisconnect_intl_2013_09_01.tsv.gz
Domesticdisconnect_YYYY_MM_DD.tsv.gzdisconnect_2013_09_01.tsv.gz

File URL and Access

All of the 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.

 

 

  • No labels