Skip to content

Mobile carrier space, by operator.

Address ranges mobile network operators assign to their subscribers, with the operator, its MCC and MNC, and the country, so a phone on cellular data is not mistaken for a proxy.

Request evaluation

Schema at a glance.

See documentation →

The database's schema and metadata are documented carefully. It is published as CSVGZ and MMDB.

start_ipend_ipnamemccmnccountryconfidence
2.165.13.02.165.14.255Telekom26201DEhigh
12.35.116.012.35.134.255AT&T310410UShigh
31.160.238.031.160.241.255KPN20408NLhigh
46.97.244.046.97.255.255Vodafone22601ROhigh
2409:8a2a:9500::2409:8a2a:98ff:ffff:ffff:ffff:ffff:ffffChina Mobile46000CNhigh
ID
carrier_ip_v1
Entries
203,272
Refresh
Daily
CSVGZ
1.41 MB
MMDB
5.10 MB

Downloading it from code.

Database API reference →

One call gets you the current Carrier IP build. Every official client wraps it three ways: straight to disk, a time-limited link you hand to your own runner, or bytes in memory. A file written to disk lands only once the whole transfer has arrived, and checksums() returns the published digests to verify it against.

download()
Streams the current build to a file, which lands only once the whole transfer has arrived, so a failed one never leaves a truncated file behind.
downloadUrl()
The time-limited link the API redirects to, for your own downloader, a job runner or a CDN pull.
downloadBytes()
The build in memory, for a small database or a pipeline that never touches a filesystem.
metadata()
Row count, file sizes and when the build last updated. Poll it and fetch only when a new one has landed.
checksums()
The md5, sha1, sha256 and sha512 digests of one file, to verify it once it lands.
import os
from internetdata import InternetData
client = InternetData(os.environ["INTERNETDATA_API_KEY"])
# what is in today's build, without moving the file
meta = client.database.metadata("carrier_ip_v1")
client.database.download("carrier_ip_v1", "mmdb", "./carrier_ip_v1.mmdb")
sums = client.database.checksums("carrier_ip_v1", "mmdb")
print(meta.updated, meta.entries, sums["sha256"])
load.pypip install internetdata
Also available for .NET, Ruby, Rust, Swift, Erlang, Perl and Zig. See all on GitHub →

Getting your hands on it.

The file is the product. Teams join Carrier IP against traffic they already log, inside their own infrastructure, and never send an address anywhere to get an answer.

Account and payment risk

Tell a phone on cellular data from a proxy, so a mobile customer is not challenged for an address their carrier shares.

Analytics

Segment traffic by mobile operator and country.

License the full database
Sales will quote on volume, term and whether you need redistribution rights.
Checksums published per file — md5, sha1, sha256 and sha512.
The id fixes the schema, so a new build never changes the columns your parser reads.
Samples are cut from the current build, not a synthetic extract.

An official client for every major language.

All SDKs on GitHub →

Twelve official clients for the languages you ship in, each wrapping the database endpoints — list what you are licensed for, poll a build, follow the download redirect, verify what landed. Install commands are in the docs.

On this page

How often does this database rebuild?

Daily. The metadata call answers when the current build landed and how many rows it holds, before you fetch it.

00 · Evaluate

Test the real build first.

An evaluation license puts a full current build in your hands — every row, every column, no sampling — so you can measure it against your own traffic before anyone talks about terms.

Request evaluation
01 · License

Then license what you use.

Standard, for detection and decisions inside your own product and operations.
Redistribution, when the data ships onward inside what you sell — priced by scope, not by seat.
Annual terms, a named contact, and flexible payment terms — monthly, quarterly or yearly.