Skip to content

MindSphere SDK for Java


The MindSphere SDK for Java enables Java developers to work with MindSphere easily. It provides a Java client implementation for the RESTful MindSphere APIs.

The MindSphere SDK for Java provides client implementations for the following APIs:

Name API Version
Asset Management 3.4
IoT Time Series 3.1
IoT TS Aggregates 3.0
IoT File 3.1
Event Management 3.5
Event Analytics 3.0

See the Getting Started for installation and configuration of an API client.

Get the SDK

You can download the MindSphere SDK for Java from the Siemens Industry Online Support (SIOS) Portal by following these links [EN]/[DE].


Client Configuration

You can easily configure the MindSphere SDK for Java through configuration parameters such as proxy settings and connection time-outs.

Authorization Handling Mechanism

The MindSphere SDK for Java provides an easy authorization handling mechanism. Developers can configure user authorization tokens or service credentials. The MindSphere SDK provides multiple ways for setting up service credentials for use in an API client. Environment variables can be set for service credential configuration to generate authorization for API calls.

Page Iterators

The MindSphere SDK for Java provides page iterator objects for easy pagination for most API clients. Developer applications can configure paging parameters and get next/previous or specific page data.


The MindSphere SDK for Java logging is configured with SLF4J, which is an abstraction layer that enables the use of any logging framework at runtime. Supported logging systems include the Java Logging Framework and Apache Log4j, among others. The MindSphere SDK logging can be enabled or disabled by the developer application.

See Logging for more information.

Exception Handling

The MindSphere SDK for Java provides an exception handling mechanism. MindSphere SDK exceptions are structured to identify client and server exceptions. Information such as error code, message, HTTP status, logref and cause can help to easy identify exceptions.

See Exception Handling for more information.

Any questions left?

Ask the community

Except where otherwise noted, content on this site is licensed under the Development License Agreement.

Last update: March 17, 2023