Skip to content

MindSphere SDK V2 for Java


The MindSphere SDK V2 for Java enables developers to work with the MindSphere IoT platform easily. It is divided into a core module and several service modules, which allows developers to include only those parts of the SDK required for their use case.

The core module provides authentication, exception handling, logging features and a common Java client implementation for the RESTful MindSphere Platform APIs. All service modules have a dependency on the core module.

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

Name API Version
SDK Core 2.2.1
Agent Management 3.2.2
Asset Management 3.9.2
Event Management 3.8.1
Event Analytics 3.1.2
IoT File 3.2.2
IoT Time Series 3.2.2
IoT TS Aggregates 3.1.2
Token Management Service 3.0.2

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

Get the SDK

The MindSphere SDK V2 for Java is available for download on the Siemens Industry Online Support (SIOS) Portal [EN]/[DE]. The SDK core and service specific modules are in JAR format and bundled into a ZIP file. It is possible to only unzip those modules you intend to use.

Download for region China 1

For region China 1, download the zip file with the suffix _region_china1 from the Siemens Industry Online Support (SIOS) Portal.


The MindSphere SDK V2 for Java provides the same core features as the previous version. It bundles these features in the core module, which is separate from the individual service modules.

MindSphere SDK Core

The core module of the MindSphere SDK V2 for Java handles authorization, client configuration, exception handling, and common API Client for the RESTful MindSphere platform APIs. All the clients have a dependency on the core module.

Client Configuration

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

Token Handling Mechanism

The MindSphere SDK V2 for Java provides an easy authorization handling mechanism. It handles technical token fetching, caching, validation and re-fetching based on user authorization tokens or service credentials configured by developers.

Refer to Token Handling for more information.


Logging is configured with SLF4J, which is an abstraction layer that enables the use of any logging framework at runtime, such as Java Logging Framework and Apache Log4j. The logging can be enabled or disabled by the developer application.

Refer to Logging for more information.

Exception Handling

The MindSphere SDK V2 for Java provides an exception handling mechanism. Different exception classes help to identify whether an exception was caused by your client or by the MindSphere server. Detailed information such as error code, message, HTTP status, logref, and cause are provided for investigation.

Refer to Exception Handling for more information.

Page Iterators

The MindSphere SDK V2 for Java provides page iterator objects for most API clients, which allows for easy pagination. Developer applications can configure paging parameters and request the next/previous page or a specific page number.

Any questions left?

Ask the community

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