Device Events XML API

This guide describes the Device Event API that is introduced with IEE v8.1 for the IEE device event interfaces. The API was restructured so that the device events are organized by Device. This structure reduces the need for duplicate event information, which reduces file size and ultimately reduces the size of the database. The new API design also reduces the number of required elements, and some of the elements have been renamed to be more intuitive. The new design also provides flexibility to allow IEE to work more easily with various collection systems.

Itron's Device Event API can upload all tamper and event information regardless of the data collection system that was used to collect the events. The new format imports all event, tamper, and leak information, and read type (counters, flags, alarms, historical events) in one single interface. This new Event API is WCF-based.

Note: The legacy API is still available. The documentation for the legacy API is available in previous versions of IEE.

IEE provides associated API materials including XSDs, WSDLs, HTML versions of the schemas, and code samples. These materials are located on the Itron Customer Center.

You can import event data through the import operation and export event data for use in external systems. The import process normalizes incoming data for storage in IEE.

For more information about database entities and tables, see the IEE Data Dictionary.

Note: All Itron web services support web services security through WS‑Security credentials and Secure Sockets Layers (SSL), when acting as web service providers. For more information, see the IEE Web Services User Guide.