Core functionalities of Trackunit Iris are powered by our suite of APIs. New capabilities are often tied to the launch of an accompanying API. So, what are APIs and how can can you leverage them?
What are APIs?
Simply put, APIs enable secure two-way communication between software. This communication enables you to have live fleet data feed into other programs like billing portals, ERP systems, or branded applications.
APIs enable you to do more with data and easily share information, simplify your day-to-day business, and streamline new revenue opportunities. For rental companies, that means enriching processes by connecting your entire mixed-fleet ecosystem. For OEMs, it means unlocking additional data points that contribute to data-driven designs.
Instead of developers needing to understand the inner workings of every software component they want to use, they can rely on the API to request what they need. This makes it easier for different programs to work together.
Leverage APIs with Trackunit’s Enriched API Capabilities
Trackunit’s API key activity can be tracked through enriched metadata including creation date, last activity, and creator details for each API key.
Below, you can read about the different purpose and use cases of each API key:
Telematics Foundation
Name: ISO Export (AEMP 2.0) API: Snapshot data access
Value: Being in front of the data sharing movement in the construction industry we serve all Machine Insights via our ISO 15143-3 API (AEMP 2.0). You will get exactly the same insights in the API as can be seen for the specific asset in Manager and Go.
Use Case: Easily integrate an up-to-date picture of your fleet’s machine insights into other vital business systems like your ERP system, show telematics data of specific assets for example, current utilization. Build dashboards to keep an overview of the current state and utilization of your fleet
Name: Location API
Value: Sync the real-time GPS coordinates of your equipment into connected programs to retrieve and track your assets.
Use Case: Maintain accurate location for all your assets in any important apps, sites, or programs. Explore tracking solutions tailored to your business, and answer the below:
where is my equipment
is my equipment at the right place
did my equipment arrive at location
is my equipment lost
Organizational Management
Name: Users API
Value: Sync any actions you take regarding users in your core systems (creating, deleting, and updating users) to your Trackunit accounts for easy administration.
Use Case: Create or update new users automatically in Trackunit whenever you make changes in your connected apps and programs. Delete users automatically across all platforms to ensure your data stays secure
Asset Administration
Name: Asset API
Value: Tracking of equipment today spans beyond machines - from large construction cranes and over excavators to compactors and power tools. We have one word that covers this span - asset.
With this API you get a singular API to retrieve handles for other APIs across your tracked inventory, independent of the telematic solutions used for tracking. This is the central API for getting a list of your entire fleet.
Use Case: Get meta data like brand, model, name and serial number (for example, VIN) of your assets. The asset_id from here is used as a key to most other APIs.
Name: Asset - Share & Transfer API
Value: Manage sharing and transferring assets from any connected system and sync the actions to your Trackunit accounts.
Use Case: Automate efficient rentals and sales of assets by syncing share or transfer actions initiated in your ERP system to Trackunit. Ensure your data stays consistent in multiple platforms without duplicating work. Maintain an accurate inventory in all of your connected systems
Name: Groups API
Value: Sync configuration of groups from Trackunit Manager to your connected programs to manage operations.
Use Case: Use information about asset groups as a foundation for dashboards and metrics to compare customers, job sites, or any other groups that are important to your business. Use groups in your ERP system to streamline the billing process
Name: Sites
Value: For contractors and rental companies with fleets and equipment spread across multiple job sites or depots, it's vital to get an up-to-the-minute view of the status of equipment on each site.
Sites provide an overview of equipment across every job site so projects can be completed faster and more efficiently.
Use Case: Sync site locations and on hand equipment to other systems and enable automated workflows based on job sites to eliminate the need for ongoing manual site-level administration
See up-to-date information about inventory in job sites and depots in your construction management software and drive efficiencies in pick-up volumes and route planning
Name: Custom Fields API
Value: Custom Fields API enables you to capture and organize metadata that holds significant contextual value, thereby facilitating more robust data categorization and retrieval processes.
Use Case: Ensures accurate representation of data, while fostering greater insights and efficiencies when analyzing or using that data. It also empowers you to adapt your data in Trackunit Iris to your evolving needs without the constraints of pre-defined schemas.
Configuration:
Name: Asset - Onboarding API
Value: Easily onboard and offboard Kin-tagged assets via API.
Use Case: Efficiently add new assets with bluetooth telematic devices to your Trackunit account
Name: Machine - Onboarding API
Value: Easily onboard and offboard machine type assets via API.
Use Case: Efficiently add new machine type assets to your Trackunit account
Name: Telematics Device API
Value: The Telematics Device API offers seamless access to an array of features to facilitate device information retrieval and configuration management, as well as to easily create oversight of a fleet of telematic devices.
Use Case: Gain the ability to programmatically manage devices and track the progress of desired configurations on each device.The API also provides developers with access to detailed device state documentation, empowering them to identify and explore untapped configuration opportunities.
Name: Alert Configuration API
Value: This API allows you to efficiently set up your alerts with the possibility for advanced configurations, such as custom scheduling.
Use Case: Set up operational and theft-based alerts. Customize scheduling of Movement Based Theft alerts
Data Archive
Name:ISO Export (AEMP 2.0) API: time series data access
Value: This API supports those who want to work with asset data over a specific time period. The time series endpoints of our ISO 15143-3 API (AEMP 2.0) serve all Machine Insights and you also get machine faults in this end point - e.g. CAN faults.
Use Case: Simple to implement, especially for small fleets, this capability is a great tool to gain insights into the historical locations or other telematics insights of an asset
Name: Time Series API
Value: This API is centred around machine numeric data over specified time ranges, therefore it will be more flexible than our AEMP/ISO-15143 API. It has the possibility to query for a selected machine insight or single value advanced sensor metrics over a specified time range and aggregate the values based on your needs (e.g. hourly, daily, weekly, monthly etc.).
Easily collect time series data about a machine - e.g. working and idle hours, fuel and DEF consumption levels, battery voltage and much more.
Use Case: Supercharge your data exploration with advanced querying capabilities using PromQL - e.g. to detect precision usage or improper use of assets. Use these highly performant API endpoints to build customised dashboards and reports by combining data from machine insights and advanced sensors of your assets.
Feature API: Service Management
Name: Service Management API
Value: Sync data from the Service Management app into your connected programs to manage the maintenance process.
Use Case: Assign upcoming or current service tasks to technicians in your workflow management system. Bring upcoming service needs into your ERP system to purchase parts and manage inventor
Feature API: Access Management
Name: Access Management API & Operators API
Value: Easily streamline who can access equipment to improve operator safety and limit unauthorized movement via APIs.
Use Case: Efficiently register and manage operators that are authorized to use your equipment. Manage digital keys and pin codes to unlock your assets from one central system
Feature API: Emissions Reporting
Name: Emissions API
Value: Easily integrate emissions data with key business systems or other data sources to streamline insights and day-to-day administration for clear insight on how you are tracking with your emissions targets.
Use Case: To enable users who need to measure and benchmark emissions either across the fleet, individual equipment, jobsites, or various time periods, the following API endpoints are available: period, daily, monthly, site, and lifetime.
In addition to the above listed REST API capabilities, we also offer a GraphQL API interface. Our REST APIs are designed to only expose a single domain within the Trackunit data model. If you need data from different parts of the Trackunit data model, consider using the GraphQL API instead of the individual REST APIs. Generally the GraphQL API also offers more flexible queries and only retrieves the data needed. Making it easier to quickly retrieve the data needed for your application.
Visit our Developer Hub to learn how you can do more with data and easily share information, simplify your day-to-day business, and streamline new revenue opportunities.
Accessing Iris APIs in Trackunit Manager
You can find your API access in the Administration tab of your Trackunit Manager account.
Log into Trackunit Manager
Go to the Administration tab
Select API Access from the menu on the left side
💡 Tip: You can follow the steps in our comprehensive API access guide from our Developer Hub here: https://developers.trackunit.com/reference/access-token
💡 Tip:
Need more help? Get support from the Trackunit Community
Find answers and get help from Trackunit Tech Support and Community Experts