---
title: "HOMAG Connect Machine Data"
slug: "data-exchange-homag-connect-homag-connect-machine-data"
updated: 2026-07-29T09:32:43Z
published: 2026-07-29T09:32:43Z
canonical: "docs.homag.cloud/data-exchange-homag-connect-homag-connect-machine-data"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.homag.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# HOMAG Connect Machine Data

The HOMAG Connect Machine Data interface gives you direct access to the raw data of your machines via a cloud interface. This provides you with comprehensive information about the current condition of your machines as well as a 90-day history. This allows you to seamlessly integrate your machine data into ERP systems or industry-specific solutions. Depending on your needs, you can also evaluate the data with analysis tools such as [Excel](/v1/docs/en/datenaustausch-homag-connect-daten-mit-excel-auswerten) or [Power BI](/v1/docs/en/datenaustausch-homag-connect-daten-mit-power-bi-auswerten) and adapt and visualize it according to your requirements.

The interface provides additional data in addition to the data in the OPC UA Woodworking Companion Specification. OPC UA (Open Platform Communications Unified Architecture) is an interface standard that ensures the standardized transmission of machine data in the furniture industry and thus ensures interoperability between machines from different manufacturers. The official description of the specification can be found [here](https://reference.opcfoundation.org/Woodworking/v100/docs/).

The HOMAG Connect Machine Data interface can be used to provide general information such as e.g. Machine identification, machine status, error and warning messages of the machine can be retrieved. It also provides access to the unprocessed data from the HOMAG MMR, e.g. Provide information about machine health, condition and part counters, as well as maintenance and shift information. In principle, the return values are identical for all HOMAG machine types. However, depending on the machine type, there are additional specific states, such as maintenance intervals of individual machine components, which can vary.

The interface is available as a paid add-on for MMR for new machines built from 2024 onwards. How to authenticate to use the interface is described in the [Authentication](/v1/docs/en/datenaustausch-homag-connect-authentifizierung) section.

## Access to machine list

The endpoint provides an overview of all machines that are assigned to your customer environment and have a license for the HOMAG Connect Machine Data interface.

The following parameters are returned:

| Parameters | Description | Example |
| --- | --- | --- |
| MachineNumber | Machine number | 0-201-10-3645 |
| MachineName | Machine Name | CENTATEQ E-310 \| 0-201-10-3645 |

## Accessing List of Parameters

The endpoint returns a list of characteristics that have occurred in the last 90 days for a given machine. These key terms are available for more detailed queries and include, for example: the current status, machine identification or part counter.

Therefore, for a selected machine, the nodes parameter is returned:

| Parameters | Description | Example |
| --- | --- | --- |
| Nodes | List of Node Names | HOMAG. Machines.Applications.MMR_V1. CurrentState Machines.State.Machine.Flags.Alarm |

![Node-Liste](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/Machine-Data-API-01.png?sv=2026-02-06&spr=https&st=2026-11-10T00%3A09%3A59Z&se=2026-11-10T01%3A09%3A59Z&sr=c&sp=r&sig=viO7Iske%2BrxzhQXFpi9HpjjwAng%2Bmy7SOEFu5xPoJyQ%3D)

Node List

## Access to current and historical data

The endpoints allow the retrieval of current and historical data based on the characteristics identified via the node list.

You can query values for the current time, for a specific period in the past, or for the entire last 90 days.

In addition to the information contained in the node list, these queries provide the following parameters:

| Parameters | Description | Example |
| --- | --- | --- |
| node | Nodename | HOMAG. Machines.Applications.MMR_V1. CurrentState |
| value | Value of the node | IdleTime_Unknown |
| Timestamp | Timestamp of when the value was reported in UCT | 2025-02-05T14:06:29.7050781Z |

![Historie einer Maschine der letzten 90 Tage](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/machine-Data-API-02.png?sv=2026-02-06&spr=https&st=2026-11-10T00%3A09%3A59Z&se=2026-11-10T01%3A09%3A59Z&sr=c&sp=r&sig=viO7Iske%2BrxzhQXFpi9HpjjwAng%2Bmy7SOEFu5xPoJyQ%3D)

History of a machine from the last 90 days

![Aktueller Maschinenzustand](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/Machine-Data-API-03.png?sv=2026-02-06&spr=https&st=2026-11-10T00%3A09%3A59Z&se=2026-11-10T01%3A09%3A59Z&sr=c&sp=r&sig=viO7Iske%2BrxzhQXFpi9HpjjwAng%2Bmy7SOEFu5xPoJyQ%3D)

Current machine condition

## Access to alerts

The endpoint gives a summary of all alerts that occurred within a specified time period for a selected machine.

| Parameters | Description | Example |
| --- | --- | --- |
| startTime | Date and time of alarm start | 2025-03-17T09:07:24.3381216+01:00 |
| endTime | Date and time of the end of the alarm | 2025-04-04T14:47:03.1261478+02:00 |
| InstanceId | Machine Instance | A046D757-988E-42B5-A1D5-6519A841DC3C |
| machineNumber | Machine number | T200695809 |
| severity | Extent of damage number between 1 (low) and 1000 (high) | 1000 |
| localizedSource | Source of the event in several languages | Edge magazine 1 left (M1-C1-MU_301L) |
| localizedMessage | Description of the event in several languages | Laser unlocked Laser unlocked |
| Category | Category of the event | Fault |
| sourceClass | Technical origin of the event | 10_DL_MU_30X |
| sourceInstance | Instance of the cause (can be several) | M1-C1-MU_301L |
| sourceMessageId | Internal MessageId | 352 |
| causality | Reason for the alarm | Unknown |

![Historie der Warnungen](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/Machine-Data-API-04.png?sv=2026-02-06&spr=https&st=2026-11-10T00%3A09%3A59Z&se=2026-11-10T01%3A09%3A59Z&sr=c&sp=r&sig=viO7Iske%2BrxzhQXFpi9HpjjwAng%2Bmy7SOEFu5xPoJyQ%3D)

History of Alerts