Skip to content
API Reference/Locations/
Request the latest event...

Trackonomy External API (1.3.0.0)

External APIs are meant for interacting with Trackonomy Platform. New endpoints will be added regularly. Current APIs enable the following:

  • retrieve location and environmental data for assets tracked with Trackonomy tapes.
  • decode Trackonomy BLE packets
  • send various messages from third party systems for integration purposes

Locations endpoint can be used for the latest event, Historical data endpoint reveals also older data with about 15 minute delay. Note that today authentication is separated for the 2 location data endpoints!

Download OpenAPI description
trackonomy-external-api.json
trackonomy-external-api.yaml
Overview
URL
https://trackonomy.ai/contact-us/
Developer Support
developers@trackonomysystems.com
Languages
Servers
Mock server
https://docs.trackonomy.com/_mock/external-api/trackonomy-external-api/
PPE API for Locations data
https://ppe.api.trackonomy.com/external/
PPE API for Historical data
https://ppe.mt.trackonomysystems.com/

Locations

This API allows to request location and environmental data for assets tracked with Trackonomy tapes.

available sensor data depends on the exact model of tape used and sensor configuration applied to the specific device. Value -255 indicates sensor unavailability.

location_detailed info can only be returned if Trackonomy indoor network is used by customer at the given location.

Operations

Request the latest event with location and environmental data

Request

Security
bearerAuth
Path
asset_idstringrequired

AWB when fetching location only, for environmental data, use your asset id associated to Trackonomy tape.

Query
eventstring

Enable sensor readings in the response, required for non-AWB asset id

Value"sensor"
Headers
customer_idstringrequired

customer_id for the request

authorized_groupsstringrequired

authorized_groups for access control

curl -i -X GET \
  'https://docs.trackonomy.com/_mock/external-api/trackonomy-external-api/locations/{asset_id}?event=sensor' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'authorized_groups: string' \
  -H 'customer_id: string'

Responses

Latest event for the specific asset, including location and optionally environmental data

Bodyapplication/json
assetsArray of objects(Asset)
uuidstring
Example: "a51799fa-4765-4f9c-9460-2d44fc2fe27f"
vendor_idstring
Example: "c59f7130-e0b7-4aff-ac6e-a97dcfbd9222"
versionstring
Example: "1.0.0"
Response
application/json
{
  "assets": [
    { … }
  ],
  "uuid": "a51799fa-4765-4f9c-9460-2d44fc2fe27f",
  "vendor_id": "c59f7130-e0b7-4aff-ac6e-a97dcfbd9222",
  "version": "1.0.0"
}

Historical data

This endpoint allows requesting historical location and environmental data based on provided filters. Up to 1 year of history is available, at once maximum 1 month or 1000 events can be fetched. If no time frame provided, the latest event is returned.

Operations

Device Management

Service to decode BLE packets either one by one or in batch

Operations

Messaging

Service to process external messages and modify device status based on the inputs. NB! Usage of the given API needs prior alignment with customer as each received message and intended behavior is different. Provided examples are some possible ways to use the endpoint.

Operations
Copyright Trackonomy Systems Inc