# Endpoints Description

This section illustrates all the endpoints that make up the OpenAPI specification for the MAT service, grouped according to the functionalities they expose.

For each endpoint, a detailed description of its functionalities is provided, along with all the parameters that can be used for its invocation. Additionally, invocation examples are provided along with their respective outcomes.

**Please note that to invoke any endpoint, you must use "Bearer" authentication as specified on** [**the dedicated page**](https://40factory.gitbook.io/mat-api-en/authentication/cloud-case/token-acquisition)**. It is assumed that authentication is always used in every call through the correct construction of the header.**

For the examples, a test MAT instance with the following characteristics was used:

* the project consists of a machine with the ID "40-line" composed of two sub-machines with IDs "M1" and "M2". When invoking an endpoint for a machine that does not have sub-machines, the "subAssetId" parameter can be ignored;
* the machine is located in the "Europe/Rome" timezone;
* the available aggregators for the project are "aggr0", "aggr1", and "aggr2", where "aggr0" represents the type of product manufactured, "aggr1" represents the operator active during production, and "aggr2" represents the format used for production;
* the URL associated with the MAT instance used in the examples is `https://matdev.40mat.com`. To interact with your own project, you will need to replace this URL with your own in all the examples.
