GET /api/v202607/dynamicReporting

Retrieves the authenticated user's saved Watts dynamic reports with optional filtering.

GetAllDynamicReportsV202607 Permissions: Reports (Run)
Use this endpoint to list the caller’s saved Watts reports or reports shared with the caller through the APIFilter query parameter. Filters can also find reports by their last successful execution time. For system Watts templates, use GET /api/v202607/dynamicReporting/template instead.

Request Headers

Header Value Required Description
ECI-ApiKey string Yes Your API key. See Authentication.
Content-Type application/json Yes All requests must specify JSON content type.

Query Parameters

Name Description Type Required
filter Optional dynamic report filter supporting last-viewed date comparisons and selection of either reports owned by or shared with the caller. string (string) Optional

Filters

Filter Description Type Operators
isRecommended Is Recommended Boolean equals
lastViewed Last Viewed Date DateTime equals not equals less than between greater than less than equal greater than equal today yesterday last 7 days last 14 days last 30 days last 60 days last 90 days
reportCategory Report Group Type String equals
reportCode Report Code String equals not equals one of like not like not one of
sharedWithMe Report shared with me Boolean equals

Responses

200 OK The request succeeded and the response body contains the requested data.

Response Body Parameters

Array of:

DynamicReportResponseV202607
Property Description Type
columns Required (defined) string[]
createdBy UserChildWithActive
UserChildWithActive properties
Property Description Type
active True when the user’s account is active and can sign in. False when the user has been deactivated; deactivated users keep their records, including reports they created and shared. Required (defined) boolean
fullName The user’s full name Required (defined) string
hiddenUser True when the user is hidden and their name should be masked in report-author popovers. False when the user’s name can be displayed. The built-in ECI user is displayed as System User. Required (defined) boolean
userCode The user code Required (defined) string
userId The user identifier Required (defined) integer (int32)
createdDate Date and time when the report was created. Required (defined) string (date-time)
description User-facing description stored on the current report version. Null when no description was supplied. Required (defined) string
dynamicReportId Unique numeric identifier of the saved dynamic report. Required (defined) integer (int32)
dynamicReportInfo User-facing saved report title. Required (defined) string
gridState Serialized grid, chart, and panel state stored on the current report version. Null when no UI state has been saved. Required (defined) string
kql KQL persisted on the current report version and used to reproduce its data. Required (defined) string
lastViewedDate Date and time when the current report version was last successfully executed. Null when the report has never been viewed. Required (defined) string (date-time)
modifiedBy UserChild
UserChild properties
Property Description Type
fullName The user’s full name string
userCode The user code string
userId The user identifier integer (int32)
modifiedDate Date and time when the current report version was most recently modified. Required (defined) string (date-time)
ownerId Unique numeric identifier of the EnergyCAP owner that contains this report. Required (defined) integer (int32)
shared True when the report has been shared with everyone, at least one user, or at least one user group. False when only the creator can see it. Required (defined) boolean
sharedWithMe True when the current caller can see this report only because it was shared with them (directly, through a user group, or with everyone). False for reports the caller created. Required (defined) boolean
visible True when the report appears in the current caller’s report list. False when the caller has hidden this shared report from their list. Always true for reports the caller created. Required (defined) boolean
wattsChatId Unique numeric identifier of the reporting chat that owns the linked assistant message. Null for legacy or unlinked reports. Required (defined) integer (int32)
wattsChatMessageId Unique numeric identifier of the assistant message associated with the saved KQL. Null for legacy or unlinked reports. Always null when the caller is not the report’s creator, because the chat belongs to the creator. Required (defined) integer (int32)
Example Response application/json 
[
  {    "columns": [
      "string"
    ],    "createdBy": {      "active": false,      "fullName": "string",      "hiddenUser": false,      "userCode": "string",      "userId": 1
    },    "createdDate": "2026-11-10",    "description": "string",    "dynamicReportId": 1,    "dynamicReportInfo": "string",    "gridState": "string",    "kql": "string",    "lastViewedDate": "2026-11-10",    "modifiedBy": {      "fullName": "string",      "userCode": "string",      "userId": 1
    },    "modifiedDate": "2026-11-10",    "ownerId": 1,    "shared": false,    "sharedWithMe": false,    "visible": false,    "wattsChatId": 1,    "wattsChatMessageId": 1
  }
]