How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

1NCE Device Locator API

Get device positions and manage geofences

1NCE Device Locator API is one of 22 APIs that 1NCE publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Device Locator. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

This API exposes 8 operations across 5 paths, and defines 39 schemas. It is described by OpenAPI 3.2.0, at version v1.3.

Requests are made against a single base URL, https://api.1nce.com/management-api.

8 operations 5 paths 39 schemas 1 DELETE5 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1.3
Server
https://api.1nce.com/management-api
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

1NCE Device Locator API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuthentication).

  • BearerAuthentication — Bearer Authentication Token used to gain access to the 1NCE API. Please refer to the Open Authorization (/oauth/token) request for obtaining a Bearer Token.

Paths & Operations 8

Across 5 paths, the API surfaces 8 operations — 1 DELETE, 5 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Device Locator 8

Get device positions and manage geofences

GET
/v1/locate/devices/{deviceId}/positions
Get Device Positions
getV1LocateDevicesByDeviceIdPositions 8 params → 200400401403500
GET
/v1/locate/positions/latest
Get Latest Devices Positions
getV1LocatePositionsLatest 11 params → 200400401403500
GET
/v1/locate/devices/{deviceId}/activity
Get Device Celltower location resolutions
getV1LocateDevicesByDeviceIdActivity 3 params → 200400401403500
GET
/v1/locate/geofences
Get all geofences
getV1LocateGeofences 5 params → 200400500
POST
/v1/locate/geofences
Create geofence
postV1LocateGeofences body → 201400401403500
DELETE
/v1/locate/geofences/{geofenceId}
Delete geofence
deleteV1LocateGeofencesByGeofenceId 1 param → 204404500
GET
/v1/locate/geofences/{geofenceId}
Get a geofence
getV1LocateGeofencesByGeofenceId 1 param → 200404500
PATCH
/v1/locate/geofences/{geofenceId}
Patch a geofence
patchV1LocateGeofencesByGeofenceId 1 param body → 200400404500

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are patchGeofenceResponseschema_oneOf_1 (10 properties), CircleGeofenceData (10 properties), patchGeofenceResponseschema_oneOf (9 properties), PolygonGeofenceData (9 properties). Each schema is shown below with its type and property counts.

Name
string
The name of the geofence
postGeofenceResponseschema
Response to post geofence request.
postschema_5
object
Request to create a geofence.
getResponseschema_9_items_inner
object
8 properties 5 required
getResponseschema_9_items_inner_towerLocation
object
Coordinates of the specific celltower
2 properties
getAllGeofenceResponseschema
object
Response to get all geofences request.
3 properties 3 required
EventTypes
array
The event types to register to. Defaults to [ENTER, EXIT]
patchGeofenceResponseschema_oneOf_1
object
10 properties 9 required
GenericGeofenceData
object
6 properties 6 required
postGeofenceResponseschema_oneOf
object
7 properties 7 required
DeviceId
The device for which this Geofence is bound to
badRequestResponse
object
An API error response in case of an HTTP Bad Request.
3 properties
getLatestResponseschema
object
Get latest positions of customer devices.
3 properties 3 required
patchschema_1
object
Request to update a geofence.
3 properties
getResponseschema_8_coordinates_inner
object
4 properties 3 required
CreatePolygonGeofence
object
6 properties 3 required
Type
string
The type of Geofence
getGeofenceResponseschema
Response to get geofence request.
serverErrorResponse
object
An API error response in case of a Server Side Error.
2 properties
Radius
number
Circle geofence radius in meters
Center
array
The coordinates of the center of the geofence (long, lat)
patchGeofenceResponseschema_oneOf
object
9 properties 8 required
getLatestResponseschema_coordinates_inner
object
5 properties 4 required
patchGeofenceResponseschema
Patch request geofence response.
Coordinates
array
The polygon geofence coordinates
CreateCircleGeofence
object
7 properties 3 required
PolygonGeofenceData
object
9 properties 9 required
Created
string
When the Geofence was created
unauthorizedRequestResponse
object
An API error response in case of an HTTP Unauthorized Request.
3 properties
getResponseschema_8
object
Get positions of a specific device.
3 properties 3 required
postGeofenceResponseschema_oneOf_1
object
8 properties 8 required
EventSources
array
The sources of coordinates to evaluate towards geofence. Defaults to [GPS, CellTower]
Updated
string
When the Geofence was last updated
forbiddenResponse
object
An API error response in case of an HTTP Forbidden Request.
3 properties
Id
string
Identifier of the geofence
getResponseschema_9
object
Get Cell location resolutions for one device (maximum of last 7 days).
1 property 1 required
CircleGeofenceData
object
10 properties 10 required
getResponseschema_9_items_inner_towerMetadata
object
Identifier attributes of the tower
4 properties
notFoundResponse
object
An API error response when a resource is Not Found.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

1nce-device-locator-api-openapi.yml Raw ↑

Other APIs 1NCE publishes across the network.

1NCE Administration Logs API
1NCE Agreements API
1NCE Bearer Authorization API
1NCE Connectivity API
1NCE Device Inspector API
1NCE Devices API
1NCE General SIMs API
1NCE IoT Integrator API
1NCE Optimizer API
1NCE Orders API
1NCE Plugin system API
1NCE Products API
Where this information came from

This is an independent, third-party profile of 1NCE Device Locator API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.