# List insights.
Pagination applies only to root elements (ScenarioId == null).
When fetching a page, include all children of those roots.
Search/filtering applies to both parent and children:
If a parent matches, return the parent with all its children.
If a child matches, return the child and its parent (even if the parent wouldn’t match by itself).

Returns a paginated list insight. Default page size is 10.

Endpoint: POST /insights
Version: v3
Security: oauth2

## Query parameters:

  - `addFloor` (boolean)
    When true, the response includes the floorId.

## Request fields (application/json):

  - `sortSpecifications` (array,null)

  - `sortSpecifications.field` (string, required)

  - `sortSpecifications.sort` (string,null)

  - `sortSpecifications.isSortDescending` (boolean)

  - `filterSpecifications` (array,null)

  - `filterSpecifications.operator` (string, required)

  - `filterSpecifications.value` (object)

  - `filterSpecifications.filterConditionOperator` (string,null)
    Enum: "And", "Or"

  - `page` (integer,null)

  - `pageSize` (integer,null)

## Response 200 fields (application/json):

  - `before` (integer)

  - `after` (integer)

  - `total` (integer)

  - `items` (array,null)

  - `items.id` (string)
    Gets or sets the unique identifier of the insight.

  - `items.customerId` (string)
    Gets or sets the unique identifier of the customer associated with the insight.

  - `items.siteId` (string)
    Gets or sets the unique identifier of the site associated with the insight.

  - `items.sequenceNumber` (string,null)
    Gets or sets the sequence number of the insight.

  - `items.equipmentId` (string,null)
    Gets or sets the unique identifier of the equipment associated with the insight.

  - `items.twinId` (string,null)
    Gets or sets the twin identifier of the insight.

  - `items.twinName` (string,null)
    Gets or sets the name of the twin associated with the insight.

  - `items.insightType` (string)
    Gets or sets the type of the insight (standard or scenario).
    Enum: "standard", "scenario"

  - `items.category` (string)
    Gets or sets the category of the insight.
    Enum: "fault", "energy", "alert", "note", "goldenStandard", "infrastructure", "integrityKpi", "energyKpi", "edgeDevice", "dataQuality", "commissioning", "comfort", "wellness", "calibration", "diagnostic", "predictive", "alarm"

  - `items.name` (string,null)
    Gets or sets the name of the insight.

  - `items.description` (string,null)
    Gets or sets the description of the insight.

  - `items.recommendation` (string,null)
    Gets or sets the recommendation for the insight.

  - `items.impactScores` (array,null)
    Gets or sets the impact scores associated with the insight.

  - `items.impactScores.name` (string,null)
    Gets or sets the name of the impact score.

  - `items.impactScores.fieldId` (string,null)
    Gets or sets the field ID of the impact score.

  - `items.impactScores.value` (number)
    Gets or sets the value of the impact score.

  - `items.impactScores.unit` (string,null)
    Gets or sets the unit of the impact score.

  - `items.impactScores.externalId` (string,null)
    Gets or sets the external ID that matches a time series in ADX.

  - `items.impactScores.ruleId` (string,null)
    Gets or sets the rule ID associated with the impact score.

  - `items.priority` (integer)
    Gets or sets the priority of the insight.

  - `items.lastStatus` (string)
    Gets or sets the last status of the insight.
    Enum: "open", "ignored", "inProgress", "resolved", "new", "deleted", "readyToResolve"

  - `items.state` (string)
    Gets or sets the state of the insight.
    Enum: "inactive", "active", "disabled", "insufficientData", "archived"

  - `items.createdDate` (string)
    Gets or sets the date when the insight was created.

  - `items.updatedDate` (string)
    Gets or sets the date when the insight was last updated.

  - `items.occurredDate` (string)
    Gets or sets the date when the insight occurred.

  - `items.detectedDate` (string)
    Gets or sets the date when the insight was detected.

  - `items.sourceType` (string)
    Gets or sets the source type of the insight.
    Enum: "Adx", "AdtQuery", "AdtMemory", "Acs"

  - `items.sourceId` (string,null)
    Gets or sets the unique identifier of the source associated with the insight.

  - `items.sourceName` (string,null)
    Gets or sets the name of the source associated with the insight.

  - `items.primaryModelId` (string,null)
    Gets or sets the primary model identifier of the insight.

  - `items.externalId` (string,null)
    Gets or sets the external identifier of the insight.

  - `items.externalStatus` (string,null)
    Gets or sets the external status of the insight.

  - `items.externalMetadata` (string,null)
    Gets or sets the external metadata of the insight.

  - `items.occurrenceCount` (integer)
    Gets or sets the occurrence count of the insight.

  - `items.createdUserId` (string,null)
    Gets or sets the unique identifier of the user who created the insight.

  - `items.ruleId` (string,null)
    Gets or sets the rule identifier associated with the insight.

  - `items.ruleName` (string,null)
    Gets or sets the rule name associated with the insight.

  - `items.newOccurrence` (boolean)
    Gets or sets a value indicating whether the insight is a new occurrence.

  - `items.previouslyIgnored` (integer)
    Gets or sets the count of times the insight was previously ignored.

  - `items.previouslyResolved` (integer)
    Gets or sets the count of times the insight was previously resolved.

  - `items.floorId` (string,null)
    Gets or sets the unique identifier of the floor associated with the insight.

  - `items.reported` (boolean)
    Gets or sets a value indicating whether the insight has been reported.

  - `items.commentCount` (integer)
    Gets or sets the comment count for the insight.

  - `items.lastResolvedDate` (string,null)
    Gets or sets the date when the insight was last resolved.

  - `items.lastIgnoredDate` (string,null)
    Gets or sets the date when the insight was last ignored.

  - `items.locationDetails` (array,null)
    Gets or sets the location details, including twin ID, name, and model ID.

  - `items.locationDetails.id` (string,null)
    Gets or sets location Id (Scope's twinId).

  - `items.locationDetails.name` (string,null)
    Gets or sets location name.

  - `items.locationDetails.modelId` (string,null)
    Gets or sets location model Id.

  - `items.tags` (array,null)
    Gets or sets the tags associated with the insight.

  - `items.ignoreUntil` (string,null)
    Gets or sets the ignore expiry date for the insight.

  - `items.openTicketCount` (integer)
    Gets or sets the number of open tickets for the insight.

  - `items.completedTicketCount` (integer)
    Gets or sets the number of Completed tickets for the insight.

  - `items.closedTicketCount` (integer)
    Gets or sets the number of closed tickets for the insight.

  - `items.ticketClosedDate` (string,null)
    Gets or sets the ticket closed date.

  - `items.ticketCompletedDate` (string,null)
    Gets or sets the ticket completed date.

  - `items.secondaryTwins` (array,null)
    Gets or sets the secondary twins "secondary components" of the insight.

  - `items.secondaryTwins.id` (string,null)
    Gets or sets twin Id.

  - `items.secondaryTwins.name` (string,null)
    Gets or sets twin Name.

  - `items.secondaryTwins.modelId` (string,null)
    Gets or sets model id.

  - `items.secondaryTwins.eTag` (string,null)
    Gets or sets unique tag of location for changes.

  - `items.recommendations` (array,null)
    Gets or sets the recommendations of the insight.

  - `items.recommendations.id` (string)
    Gets or sets the unique identifier for the recommendation.

  - `items.recommendations.name` (string,null)
    Gets or sets the name of the recommendation.

  - `items.recommendations.recommendation` (string,null)
    Gets or sets the recommendation.

  - `items.recommendations.tags` (array,null)
    Gets or sets the tags for recommendation.

  - `items.recommendations.ignored` (boolean)
    Gets or sets a value indicating whether the recommendation is ignored or not.

  - `items.recommendations.tickets` (array,null)
    Gets or sets the recommendation's tickets.

  - `items.recommendations.tickets.id` (string)
    Gets or sets the ticket id.

  - `items.recommendations.tickets.summary` (string,null)
    Gets or sets the ticket summary.

  - `items.recommendations.tickets.createdDate` (string)
    Gets or sets the ticket created date.

  - `items.recommendations.tickets.ticketStatus` (object,null)
    Gets or sets the ticket status details.

  - `items.recommendations.tickets.ticketStatus.id` (string)
    Gets or sets the unique identifier for the ticket status.

  - `items.recommendations.tickets.ticketStatus.name` (string,null)
    Gets or sets the name of the ticket status.

  - `items.recommendations.tickets.ticketStatus.tab` (string,null)
    Gets or sets the status's tab that can be used to filter ticket status in UI.

  - `items.recommendations.tickets.ticketStatus.color` (string,null)
    Gets or sets the color associated with the ticket status.

  - `items.dependencyCount` (integer)
    Gets or sets the number of insight's dependencies.

  - `items.actionStatus` (string)
    Gets or sets the action status of the insight.
    Enum: "needsAction", "inProgress", "unsuccessfullyActioned", "successfullyActioned"

  - `items.scenarioId` (string,null)
    Gets or sets the insights parent scenario id.

  - `items.scenarioName` (string,null)
    Gets or sets the insights parent scenario name.

  - `items.type` (string)
    Gets or sets the type of the insight.
    Enum: "fault", "energy", "alert", "note", "goldenStandard", "infrastructure", "integrityKpi", "energyKpi", "edgeDevice", "dataQuality", "commissioning", "comfort", "wellness", "calibration", "diagnostic", "predictive", "alarm"

  - `items.locations` (array,null)
    Gets or sets the locations associated with the insight.

  - `items.isDiagnosticsData` (boolean)
    Gets or sets a value indicating whether the insight contains diagnostics data.