Open API Overview

The Tenna Open API provides programmatic access to your Tenna account, enabling you to build custom integrations, automate workflows, and extend the value of your data across your technology ecosystem. The API consists of two distinct components: the "Read- Only API" and the "Integrations API".

Each API serves a different purpose, requires a separate license, and uses its own authorization method. Both rely on API tokens that can be provided by reaching out to your Tenna Account Manager or Customer Support.

💥Open API requires separate licenses. There is a separate license for Open API- Read Only, and one for Open API- Integrations. There is also a need for separate API tokens. Please contact your Account Manager for more information on licenses or reach out to Customer Support at help@tenna.com or call 888.836.6269.

Read-Only API

The Read-Only API provides comprehensive, read-only access to your Tenna reporting data across a wide range of endpoints. It is designed to facilitate easy retrieval of detailed information and supports operational needs such as asset tracking, utilization monitoring, financial oversight, and maintenance scheduling.

Report data is automatically refreshed on a daily basis. It is important to note that recent changes made to account data will not immediately be available when using this API- there is a delay until the next daily refresh cycle.

Capabilities

• Filtering: Narrow results to exactly the data you need
• Pagination: Efficiently retrieve large datasets in manageable chunks
• Sorting: Order results by the fields that matter most to your workflow
• Relational Data: Receive the entire chain of data relations in a single request

Data Available

• Assets and equipment details
• Sites and locations
• Contacts, users, and companies
• Time entries and timecards
• Scorecards and threshold events
• Fuel entries
• Tracker pings, geofence breaches, and trip data
• Parts and inventory
• Cost codes and billing rates
• Work orders and maintenance records
• Class codes and organizations

Use Cases

Custom Reporting and Business Intelligence

Tenna's data can be exported and connected to BI tools like Power BI, Tableau, or Excel, allowing you to build custom dashboards and reports outside of Tenna's standard reporting views. This is useful for KPIs or reporting structures that require a tailored look at metrics like asset utilization, fuel consumption, or maintenance trends.

ERP and Accounting System Integration

Equipment cost data, utilization summaries, and billing information from Tenna can be pushed to your ERP or accounting platform, keeping your financial systems aligned with what's happening in the field. This reduces the need for manual data entry and helps ensure that the numbers in your financial tools reflect accurate, up-to-date operational data.

Payroll and Time Tracking

Export timecard and time entry data from Tenna for use in your payroll processing systems. Automate the flow of approved time data to reduce manual effort and errors in pay cycles.

Fleet and Asset Analysis

Pull asset, trip, and ping data to perform detailed fleet analysis- including utilization rates, idle time, movement patterns, and geographic distribution. Use this data to optimize fleet size, reduce costs, and improve operational planning.

Maintenance Planning

Retrieve work order and maintenance data to feed into external CMMS or to build predicative maintenance models that help you stay ahead of equipment failures.

Important Considerations

• Data is refreshed once per day: real-time changes are not immediately reflected.
• The API rate limit is 5 requests per second per account (not per token). Exceeding this limit will result in a "429 Too Many Requests" response.
• Authentication uses JWT tokens, separate from Integrations API tokens.

Integrations API

The Integrations API provides the ability to create and update data in your Tenna account. Unlike the Read-Only API, data changed through this API is reflected immediately in the Tenna web and mobile apps, enabling real-time synchronization between Tenna and your external systems.

Capabilities

• Create and Update: Full write access to supported Tenna entities
• Natural Key Lookups: Reference objects by well-known identifiers (fleet number, employee ID, name) rather than Tenna internal Ids, simplifying integration development
• Bulk Operations: Process multiple records in a single request (up to 100 records per call) to efficiently synchronize large datasets
• Immediate Reflection: Changes appear instantly across Tenna web and mobile applications

Support Entities

• Assets: Manage your equipment and asset records
• Users: Provision and update workforce
• Fuel Entries: Create and update fuel transaction records
• ... many more coming soon

Use Cases

Fuel Management System Integration

Fuel transaction data from platforms like WEX, Coast, and Comdata can be imported into Tenna automatically through a direct integration. This ensures fuel consumption records stay accurate and are tied to the right assets, operators, and sites without requiring manual input.

HR and Workforce Synchronization

If your organization manages workforce data in an HR platform like Workday, ADP, or BambooHR, that information can be synced to Tenna to keep user profiles and access current. Changes made in your HR system- new hires, role updates, departures, etc. are reflected in Tenna without requiring a separate manual update.

Project Management Synchronization

Coming Soon! Automatically create and update site and job records; ensure that asset assignments, utilization tracking, and cost allocation align with your active projects.

ERP Data Synchronization

Coming Soon! Integrate with parts procurement platforms (such as Gearflow) to automatically write part request data into Tenna. Streamline the parts ordering process and keep your maintenance and parts inventory records in sync across systems.

Custom Automation and Workflows

Coming Soon! Build custom automated workflows that respond to events in your external systems by writing data into Tenna. For example, automatically create a site in Tenna when a new project is created in your project management system, or update asset records when equipment is transferred between divisions.

Important Considerations

• Changes made through the Integrations API are reflected immediately in Tenna.
• The API rate limit is 2 requests per second per account (not per token). Exceeding this limit will result in a "429 Too Many Requests" response.
• Bulk operations support up to 100 records per request.
• Authentication uses JWT tokens, separate from Read-Only API tokens.

Getting Started

Comparison at a Glance