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/getAlso accepts POST requests.
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. See Errors for error 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.
Availability
Each user receives 1,000 API request credits per day. For more credits or commercial plans, see Access and limits.