Resources

Carrier Data

Resources

Carrier data is packaged in a binary format, which is highly compressed to reduce server footprint, and optimized for speed of search and retrieval. It can either be downloaded manually or fetched with an automated script.

Download frequency

The carrier data is updated daily, and we recommend that you update the data file on a regular basis to ensure you have the most up-to-date mobile carriers data.

Automatic downloads

It is strongly recommended to setup a regular automated data download. The data file can be downloaded from this simple download page by passing the correct parameters in the URL. Either HTTP or HTTPs can be used to fetch the carrier data.

URL: https://deviceatlas.com/getCarrierData.php

Download parameters

The download request must use the following parameters:

licencekey=YOUR_LICENCE_KEY

License key for your account.

format=[zip|gzip]

Compression format.

md5=[1|0]

Optional parameter. Set to "1" to download the MD5 file for the JSON.

Examples

Download the latest data file in zip format:
https://deviceatlas.com/getCarrierData.php?licencekey=LICENCE_KEY&format=zip

Download the MD5 checksum file for the latest data file:
https://deviceatlas.com/getCarrierData.php?licencekey=LICENCE_KEY&format=zip&md5=1

Download verification

Verification of a downloaded data file is very important to ensure the whole file was received and it is not corrupted. Setting the MD5 parameter to "1" will download a text file containing the MD5 hash of the main data file which can then be compared against the full data file.

Installing the data file

Once the data file is downloaded the DeviceAtlas Carrier API needs to be told to reload it. This is a simple process and can be done as follows, typically taking a fraction of a second. Device recognition is not affected during a data file reload.

Examples

Java:  carrierApi.loadDataFromFile("/path/to/DeviceAtlas.data");

.NET:  carrierApi.LoadDataFromFile("/path/to/DeviceAtlas.dat");

PHP:  $carrierApi->loadDataFromFile("/path/to/DeviceAtlas.dat");

Take a look at the documentation specific to your API for further details.

 

Master Carrier List

For the list of all supported mobile carriers you can either visit the Master Carrier List page or use the download interface for an automated script.

Automatic downloads

The data file can be downloaded from this simple download page by passing the correct parameters in the URL. Either HTTP or HTTPs can be used to fetch the carrier data.

URL: https://deviceatlas.com/getMasterCarrierList.php

Download parameters

The download request must use the following parameters:

licencekey=YOUR_LICENCE_KEY

License key for your account.

type=[xml|csv]

Data format.

format=[zip|gzip]

Compression format.

md5=[1|0]

Optional parameter. Set to "1" to download the MD5 file for the JSON.

Example

Download the latest data in CSV format, compressed by zip:
https://deviceatlas.com/getMasterCarrierList.php?licencekey=LICENCE_KEY&type=csv&format=zip

Create amazing web presences on any screen
goMobi

Learn everything about mobile web technology
mobiForge

Evaluate your websites’ mobile readiness
mobiReady

© 2017 Afilias Technologies Ltd (dotMobi). All rights reserved.

This is a website of Afilias Technologies Ltd, a private company limited by shares, incorporated and registered in the Republic of Ireland with registered number 398040 and registered office at 6th Floor, 2 Grand Canal Square, Dublin 2, Ireland

IAB Certified Member