scope:

The purpose of the present document is the definition of a standard API for Context Information Management (NGSI-LD API) enabling close to real-time access to information coming from many different sources (not only IoT data sources). The present document defines how such an API enables applications to perform updates on context, register context providers which can be queried to get updates on context, query information on current and historic context information and subscribe to receive notifications of context changes. The criteria for choice of the API characteristics are based on requirements resulting from the Use Cases [i.1] and other work items [i.2] and [i.8].

The present document leverages on ETSI GS CIM 004 [i.16] prelimAPI specification, providing additions and corrections, based on feedback about ETSI GS CIM 004 [i.16] received from other SDOs as well as developers in the linked-data, internet-of-things, and mobile-apps and smart-applications communities, as well as from end users and stakeholders. In particular, it contains the resolution of some of the open issues and proposed features in annexes of ETSI GS CIM 004 [i.16].