Upload JSON measurements

Uploading measurements from a JSON file

POST https://opencellid.org/measure/uploadJson

Send a multipart/form-data request containing your API key and a measurement file.

Form fields

Name	Type	Required	Description
`key`	string	Yes	Your OpenCellID API key.
`datafile`	file	Yes	Measurement file, up to 2 MB. Split larger uploads into multiple files.

File contents

Use a measurements array containing one object per observation. This example contains the required fields for a GSM observation:

{
  "measurements": [
    {
      "mcc": 262,
      "mnc": 2,
      "lac": 434,
      "cellid": 9200,
      "lon": 9.436598,
      "lat": 52.892139
    }
  ]
}

Supported fields: mcc, mnc, lac, cellid, lat, lon, signal, measured_at, rating, speed, direction, act, ta, psc, tac, pci, sid, nid, bid. See Measurement fields for types, required fields and network-specific alternatives.

Example request

Save your measurements as measurements.json and replace YOUR_API_KEY with your key.

curl "https://opencellid.org/measure/uploadJson" \
  -F "key=YOUR_API_KEY" \
  -F "[email protected];type=text/plain"

Response

An accepted upload returns HTTP 200 with this plain-text body:

0,OK

Errors can also return HTTP 200. Check the response body and see Measurement submission errors for key, file-upload and service errors.

For processing stages and when cell positions update, see Processing time.

API overview · Measurement fields · Errors