1N1nce
Device Locator

Get Latest Devices Positions

Get latest positions of customer devices (maximum of last 7 days). Only one latest position is possible for a single device independent of source: either Celltower or GPS. This means that source query parameter selection can lead to no latest position returned for some devices. Creative Commons License OpenCelliD Project is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

get/v1/locate/positions/latest

Request

  • Base URL
    https://api.1nce.com/management-api
  • Auth
    HTTP bearer

Query parameters

deviceIdstring
Example:<device_id>

The unique device ID which identifies each 1NCE SIM. Can be obtained from the Get All Devices API query. For 1NCE SIMS the device ID is equal to its iccid.

pageinteger

Number of the requested page. Use this parameter to iterate through all items on the different pages. The total amount of pages is listed in the response body (pageAmount).

sortstring[]

Comma seperated list of device property keys in order. Prefix key with - to sort descending.

source'GPS' | 'CellTower'

Source of the position.

startDateTimestring
Example:2022-01-01T01:01:01.000Z
endDateTimestring
Example:2022-01-01T01:01:02Z
longitudeFromnumber
Example:-10
longitudeTonumber
Example:10
latitudeFromnumber
Example:-10
latitudeTonumber
Example:10
pageSizeinteger
Example:10

Parameter for specifying the queried items per page.

Response

OK

pagenumber required

The current page number of the positions.

pageAmountnumber required

The total amount of pages needed to show all positions.

Example response

{
  "page": 1,
  "pageAmount": 10,
  "coordinates": [
    {
      "deviceId": "<device_id>",
      "sampleTime": "2022-03-07T08:51:29.015Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.