localhost:3000), configure the allowed origins list.The WinCC REST API is a modern web service interface introduced in SIMATIC WinCC Professional (TIA Portal) and WinCC Unified (the latest generation of Siemens’ HMI/SCADA system). It allows external clients (e.g., web dashboards, MES, ERP, third-party applications, or custom scripts) to interact with WinCC runtime data over standard HTTP/HTTPS protocols.
Unlike classic OPC or proprietary Siemens protocols (like S7 communication), the REST API uses JSON payloads, making it language-agnostic and cloud-friendly. This bridges the gap between industrial automation and enterprise IT systems.
WinCC OA has its own robust REST API (Control Gateway). It is not identical to the TIA/WinCC Classic APIs.
Crucial Note: The open-source community has also built unofficial wrappers (e.g., pyWinCC or Node-RED contrib nodes), but this article focuses on the official Siemens REST API available in TIA Portal WinCC Professional.
While powerful, the WinCC REST API is not a silver bullet for all connectivity needs. wincc rest api
Licensing:
Performance:
Configuration overhead:
What can you actually do with the WinCC REST API? The typical feature set includes: Cross-origin Resource Sharing (CORS): If you are calling
| Feature | Description | Method Example |
| :--- | :--- | :--- |
| Read Tag Value | Fetch current value of a single or multiple data points (datapoints). | GET /api/dp/$dpName |
| Write Tag Value | Send a command to change a setpoint or control a valve. | PUT /api/dp/$dpName (Body: "value": 50) |
| Get Alarm List | Retrieve active or archived alarms/events. | GET /api/alerts/active |
| Acknowledge Alarm | Confirm an alarm from a remote dashboard. | POST /api/alert/$alertId/acknowledge |
| Query Archive Data | Retrieve historical trends for a time range. | GET /api/history/$dpName?start=...&end=... |
| User Authentication | Log in/out, check permissions. | POST /api/auth/login |
| Browse Data Points | Discover the tag structure dynamically. | GET /api/dp/browse?path=System1. |
The responses are typically clean JSON, making integration with modern JavaScript frameworks (React, Angular, Vue) or Python analytics scripts trivial.
The WinCC REST API is not a gimmick; it is a strategic enabler for Industry 4.0. By leveraging standard HTTP and JSON, your Siemens SCADA system can seamlessly feed data into cloud platforms (AWS, Azure, Google Cloud), modern databases (InfluxDB, TimescaleDB), and web frameworks (React, Vue, Angular).
Key Takeaways:
Whether you are building a custom analytics dashboard, integrating with SAP, or simply giving your shift supervisors a mobile view of the line, the WinCC REST API empowers you to break the proprietary chains of legacy automation.
Next Steps:
The era of locked-in SCADA data is ending. With the WinCC REST API, your data is finally free to flow where it adds the most value.
The Siemens WinCC REST API represents a paradigm shift in industrial automation connectivity. Traditionally, accessing data from Supervisory Control and Data Acquisition (SCADA) systems like WinCC required proprietary drivers, OPC (OLE for Process Control) DA/AE, or direct SQL database access. The introduction of the REST API (introduced prominently in WinCC V7.5 and expanded in WinCC Unified) decouples data access from the Windows ecosystem, enabling cross-platform connectivity, mobile integration, and easy adoption by IT developers unfamiliar with industrial protocols. Download the runtime to the target device and
https://<WinCC-IP>:<port>/api/v1/tags (you should get a login prompt or JSON response).