Skip to main content
Iris APIs 101

Read this article to learn about our rich API offerings that will help you simplify you day-to-day business and leverage your data.

Updated over 5 months ago

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.

Picture 1.png


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.

  1. Log into Trackunit Manager

  2. Go to the Administration tab

  3. 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


Did this answer your question?