Unified Data Model

Makini uses its own naming schema for all entities across every supported platform. This means your code works the same way regardless of which system is connected — whether it's SAP, Odoo, UpKeep, or any other supported platform.

The industrial software landscape is wide and complex. Different systems use different names, structures, and conventions for similar data. Makini simplifies this by distilling data into a basic, easy-to-understand form.

Standard Fields

Every entity in the Makini data model includes the following standard fields:

Entity

In addition to these standard fields, each entity type has its own specific fields. Refer to the API Reference for full schemas.

Response Structure

All list endpoints return a consistent response format:

{
    "data": [
        {
            "id": "makini-uuid-here",
            "_idValue": "WO-10042",
            "_displayValue": "Quarterly pump inspection",
            "_createdAt": "2025-09-15T08:30:00Z",
            "_updatedAt": "2025-10-01T14:22:00Z",
            "_deletedAt": null,
            "_implements": "..."
        }
    ],
    "meta": {
        "current_page": 1,
        "last_page": 12,
        "per_page": 50,
        "total": 573
    }
}

The data array contains the entities, and meta provides pagination information for navigating through results.

Unified Data Model

Standard Fields#

Response Structure#

Standard Fields

Response Structure