1N1nce
Device Locator

Get Device Positions

Get positions of a specific device (maximum of last 7 days). Creative Commons License OpenCelliD Project is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

get/v1/locate/devices/{deviceId}/positions

Request

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

Path parameters

deviceIdstring required
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.

Query parameters

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
pageSizeinteger
Example:10

Parameter for specifying the queried items per page.

mode'ALL' | 'SUMMARY'

Use ALL for a paginated list of all positions and SUMMARY to get the first, last and some positions inbetween.

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
}

Changes

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