BI Integration API
The BI Integration API provides flattened data exports optimized for Business Intelligence tools. Access device and asset data in a format that's easy to import into Power BI, Tableau, Excel, and other analytics platforms.
https://api.nomid.tech/emm/api/bi/v1Why a Separate API?
Business Intelligence tools often struggle with nested JSON structures. The BI API solves this by providing the same data in a flattened format.
Public API (/api/v1)
- Nested DTOs for rich object relationships
- Ideal for application development
- Multiple levels of object hierarchy
BI API (/api/bi/v1)
- All properties flattened to top level
- Direct column mapping for BI tools
- Same data, optimized structure
Response Format Comparison
The same asset data is returned in different formats depending on which API you use.
Public API /api/v1
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"syncedAt": "2026-01-29T08:15:00Z",
"customData": {
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_xyz789",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse"
}
}BI API /api/bi/v1
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"lastSyncAt": "2026-01-29T08:15:00Z",
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"],
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung",
"policyPathName": "enterprises/acme/policies/warehouse",
"policyDisplayName": "Warehouse Policy",
"policyGroupName": "Logistics"
}Available Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /assets | List all assets (flattened DTO) |
| GET | /assets/count | Get total count of assets |
| GET | /assets/{assetId} | Get a specific asset (flattened DTO) |
Authentication
The BI API uses the same API key authentication as the Public API. Include your API key in the X-API-Key header with every request.
Common Use Cases
Power BI Dashboards
Tableau Reports
Excel Data Connections
Custom Analytics Pipelines
Get Started
View the complete BI Assets endpoint documentation with code examples and response schemas.
BI Assets Documentation