Web Service Documentation / Categories / Connection/Share Services / Get Notifications
Updated on December 1, 2021
This web service returns a list of notifications that are generated when another user deletes or unshares a property or meter that you have access to. The purpose of these notifications is to help you stay in synch with your customer's data. Once a notification is read, it is marked as read (by default) and will not be available in subsequent calls. An option is available to mark those notifications as unread.
The possible notification types are:
UNSHARE - Indicates that your access to a property or meter has been removed.
SHAREUPDATE - Indicates that your access level to a property or meter has changed.
The DISCONNECT and TRANSFERPROPERTY notification types are not supported in the Test environment. Please see this FAQ page for more information.
23.0
GET
/notification/list?clear=(clear)
Field Name | Value | Comments |
---|---|---|
Authorization | Basic credentials |
Yes
Parameter Name | Description |
---|---|
clear | Indicates whether to mark the notifications as read (set to true) or unread (set to false). This is optional and the default is true. |
Request/Response | Schema Name |
---|---|
Request | None |
Response | authorization.xsd |
The following example retrieves the list of notifications. By default, the notifications are marked as read. Any subsequent calls will not include these notification items.
GET /notification/list
The following example retrieves the list of notifications and marks the notifications as read. Any subsequent calls will not include these notification items.
GET /notification/list?clear=true
The following example retrieves the list of notifications and marks the notifications as unread. Any subsequent calls will include these notification items.
GET /notification/list?clear=false
The following example lists the current set of notifications.
<?xml version="1.0" encoding="UTF-8"?>
<notificationList>
<notification>
<notificationTypeCode>UNSHARE</notificationTypeCode>
<notificationId>1</notificationId>
<description>Electric Meter - Share terminated by John Doe.</description>
<accountId>68005</accountId>
<username>acme_user</username>
<propertyId>5000006</propertyId>
<meterId>2</meterId>
<notificationCreatedDate>2014-12-20T11:50:44-04:00</notificationCreatedDate>
<notificationCreatedBy>acme_john</notificationCreatedBy>
<notificationCreatedByAccountId>68005</notificationCreatedByAccountId>
</notification>
<notification>
<notificationTypeCode>DISCONNECT</notificationTypeCode>
<notificationId>2</notificationId>
<description>You are disconnected from Jane Doe.</description>
<accountId>68032</accountId>
<username>bsimpson</username>
<notificationCreatedDate>2014-12-21T11:50:44-04:00</notificationCreatedDate>
<notificationCreatedBy>acme_jane</notificationCreatedBy>
<notificationCreatedByAccountId>68032</notificationCreatedByAccountId>
</notification>
<notification>
<notificationTypeCode>SHAREUPDATE</notificationTypeCode>
<notificationId>3</notificationId>
<description>Office Suite #10 - Access level revised to Exchange Data - Read Only by Joe Doe.</description>
<accountId>68005</accountId>
<username>snoopy</username>
<propertyId>5000206</propertyId>
<notificationCreatedDate>2014-12-21T10:50:44-04:00</notificationCreatedDate>
<notificationCreatedBy>acme_joe</notificationCreatedBy>
<notificationCreatedByAccountId>98866</notificationCreatedByAccountId>
</notification>
<notification>
<notificationTypeCode>TRANSFERPROPERTY</notificationTypeCode>
<notificationId>4</notificationId>
<description>Shoreline Building (453211) has been transferred to owner account UTCOwner (202270)</description>
<accountId>202270</accountId>
<username>mjordan</username>
<propertyId>453211</propertyId>
<notificationCreatedDate>2014-12-19T10:50:44-04:00</notificationCreatedDate>
<notificationCreatedBy>acme_jack</notificationCreatedBy>
<notificationCreatedByAccountId>6574</notificationCreatedByAccountId>
</notification>
</notificationList>