Get cell position
Look up a cell using its network identifiers.
Community coverage
OpenCellID relies on community observations, so coverage varies. A missing result can mean an unobserved cell, changed identifiers or a network-identifier mismatch. See Coverage and missing cells.
Getting cell position
GET https://opencellid.org/cell/getSend parameters in the URL query string.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
key | string | Yes | API key assigned to the user |
mcc | integer | Yes | Mobile country code |
mnc | integer | Yes | Mobile network code or system identifier |
lac | integer | Yes | Local area code, tracking area code or network id |
cellid | integer | Yes | Cell id or base station id |
radio | string | No | You can specifiy GSM, UMTS, LTE, NBIOT, NR or CDMA as the radio of returned cell. Otherwise first matched cell will be returned. |
format | string | No | You can specifiy xml, at or json as output. Default is xml. |
Example request
Replace YOUR_API_KEY with your key.
curl "https://opencellid.org/cell/get?key=YOUR_API_KEY&mcc=260&mnc=2&lac=10250&cellid=26511&radio=UMTS&format=json"Response
Successful requests return HTTP 200. Some errors also use HTTP 200, so check the response body. See Cell API errors for error codes, HTTP statuses and response formats.
Coordinates are rounded to up to 4 decimal places (2 for MCCs 404–406). Trailing zeros may be omitted. samples uses a positive upstream sample count when available, otherwise 1.
XML
<?xml version="1.0"?>
<rsp stat="ok"><cell lat="39.5691" lon="-105.0026" mcc="310" mnc="410" lac="7033" cellid="17811" averageSignalStrength="0" range="1695" samples="1" changeable="1" radio="GSM" rnc="0" cid="0" tac="0" sid="0" nid="0" bid="0" message=""/></rsp>JSON
{
"lat": 39.5691,
"lon": -105.0026,
"mcc": 310,
"mnc": 410,
"lac": 7033,
"cellid": 17811,
"averageSignalStrength": 0,
"range": 1695,
"samples": 1,
"changeable": 1,
"radio": "GSM",
"rnc": 0,
"cid": 0,
"tac": 0,
"sid": 0,
"nid": 0,
"bid": 0,
"message": null
}AT
+Location:39.5691,-105.0026,1788663346message passes through an upstream success message when present; otherwise it is null.
When sharing or publicly displaying these results, attribution is required under CC BY-SA 4.0. See License and attribution for credit text and the full requirements.
Availability
Each user receives 1,000 API request credits per day. For more credits or commercial plans, see Access and limits.