Core concepts

Before you touch an endpoint, it helps to know the core concepts that make up Hiboo and that appear throughout the API and Application.

Fleet Administration

Manage the assets you own and the metadata around them.

• Organization – It is composed of all your machines, users, zones. It is the logical receptacle of all your data in Hiboo. One user belongs to only one organization.

• Workspace – It belongs to an Organization, it is a group of machines, users and zones that you could map to a Business Unit, a Job type or any sub division that makes sense for your enterprise

• Equipment – Single machine uniquely identified by an Hiboo ID.

• Custom Field – User‑defined metadata that you attach to equipment (e.g., Cost Code, Site).

• Document – Any file linked to equipment such as an inspection report, spec sheet or photo.

Mixed‑Fleet Data

Query harmonized telematics metrics no matter the source.

• Data Source – the upstream system supplying raw data (e.g., Caterpillar, Komatsu, Samsara). Managed under Catalog in the Hiboo App.

• Integrations - Your Organization + A Data Source + Your credentials = an Integration. Managed under Integrations in the Hiboo App

• Data Kind – a normalized datapoint such as operating hours, fuel %, GPS location or fault code.

Hiboo Connect (e.g. Data Sharing)

Securely grant partners or customers scoped access to your fleet data.

• Connect Share – a time‑bound way that exposes a chosen subset of fleet data to a third party.

• Scope – the filters that limit what a share can see (Machine, metrics, date range). Configured when you create or edit a share.