API reference

Upload CSV measurements

Submit a batch of measurements in a CSV file.

Uploading measurements from a CSV file

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

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

Form fields

NameTypeRequiredDescription
keystringYesYour OpenCellID API key.
datafilefileYesMeasurement file, up to 2 MB. Split larger uploads into multiple files.

File contents

Include a header row with the field names. This example contains the required fields for a GSM observation:

mcc,mnc,lac,cellid,lon,lat
262,2,434,9200,9.436598,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.csv and replace YOUR_API_KEY with your key.

curl "https://opencellid.org/measure/uploadCsv" \
  -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

On this page