Locations & carriers

Mobile coverage spans 80+ countries with at least one major carrier per country. Unlike residential, mobile is carrier-first, geography-second — asn (the carrier) is usually a bigger lever than state or city.

Country (region)

Required. Lowercase ISO-3166 alpha-2.

helo_s1a2b3c4d5e-type-mob-region-us

Top markets by pool size: US, GB, DE, FR, JP, KR, BR, IN, ID, MX, CA, AU.

For the live list:

curl -H "Authorization: Bearer API_KEY" \
     https://api.helodata.com/v1/mobile/locations

Carrier (ASN)

The mobile carrier you want to look like. Highly recommended on every mobile workload — see ASN targeting for the full table and rationale.

helo_s1a2b3c4d5e-type-mob-region-us-asn-6167   # Verizon Wireless
helo_s1a2b3c4d5e-type-mob-region-jp-asn-2516   # KDDI
helo_s1a2b3c4d5e-type-mob-region-de-asn-3209   # Vodafone DE

State / city (limited)

state and city are accepted but the live pool is usually small. Use only in tier-1 markets and only when geo precision is critical:

helo_s1a2b3c4d5e-type-mob-region-us-state-ca-city-la-asn-6167

If the combined filter has fewer than 10 live IPs, the gateway returns 522 + X-Helodata-Insufficient-Pool: true. Drop city first, then state.

Major carriers per top market

Country	Carrier	ASN
US	Verizon Wireless	6167
US	T-Mobile	21928
US	AT&T Mobility	20057
GB	EE / BT	12576
GB	Vodafone UK	12969
DE	Deutsche Telekom / Telekom DE	3320
DE	Vodafone DE	3209
DE	Telefónica O2 DE	6805
FR	Orange	3215
FR	SFR	15557
JP	KDDI	2516
JP	NTT Docomo	9605
JP	SoftBank	17676
KR	SK Telecom	9318
BR	Vivo / Telefónica BR	26599
IN	Reliance Jio	55836
IN	Airtel	24560

The ASNs listed are the public BGP ASNs; some carriers route mobile traffic through multiple ASNs. The API endpoint above lists every routable ASN per country.

Why state/city is often empty on mobile

Mobile devices move. The geo data we have for a SIM is at best metro-area accuracy and at worst country-only (when the carrier doesn't expose finer info). When city granularity is needed, residential is the better tool.

Coverage at a glance

Coverage	Count
Countries with live IPs	80+
Countries with multiple carriers	30+
Tier-1 markets (deep pools)	12