👩‍💻

Using our Data API

With our app, you can save and export measurements. However, sometimes you need more advanced access than this. For instance, if you would like to perform the export in an automated way.

For this reason, we have created a data access API (application programming interface). It allows you to access data using scripts and obtain detailed insights into your processes.

The documentation and source code examples can be found here.

The Data API is currently provided free of charge but we reserve the right to make it subject to a (reasonable) paid subscription agreement in the future, as we develop our Cloud interface. For further information, please contact us on [email protected] with the details of your planned use - we might be able to give you guarantees of perpetual free use depending on your use case.

How to use out Data API

Step 1 - Obtain API credentials

Phone/Tablet version

Desktop version

Open the Matoha App and tap on the purple circle on the top right corner of your screen.

Click on "API key" from the drop down menu that appears.

Use the copy buttons to copy your credentials from the app.

❌

Anyone with the access to your user ID and API key will have access to your data so please keep it secure! If you are yet to purchase a device, please contact us for demo credentials.

Open the Web App and click on "API key" in the left hand side menu or click on the purple circle on the top right corner of your screen.

Use the copy buttons to copy your credentials from the app.

❌

Anyone with the access to your user ID and API key will have access to your data so please keep it secure! If you are yet to purchase a device, please contact us for demo credentials.

Step 2 - Try out API demo

Please visit https://api.matoha.com . There, click on "Authorize".

Then, scroll up to find the "BasicAuth" section. Fill in your API credentials and click Authorize.

Then, scroll down to the data type you wish to retrieve. For instance, to get the measurements, scroll to /measurements. Click on "Try it out".

There are various parameters you can adjust - for instance in case of measurements, you need to select the device type as highlighted above.

Finally, click on Execute. The response of the API will be shown, as well as the URL you can copy to your application, such as PowerBI (cyan arrow in the screenshot below).

Any questions? Please do get in touch at [email protected], we would love to help you!