# Intelligence Service Integration

The Intelligence Service processes building and event data into aggregated energy statistics, forecasts, and peer comparisons. These endpoints power the **Households Dashboard** — giving end users insight into their energy consumption, generation, and how they compare to similar households.

### How It Works

<figure><img src="/files/QrLXuVGRl2We21TfnISb" alt=""><figcaption></figcaption></figure>

1. You send events to the MOOST platform (see [Common Integration](/technical-integration/cloud-to-cloud-integration/common-integration.md#add-events)).
2. MOOST aggregates and processes the raw event data.
3. Your application polls the energy-statistics and energy-forecast endpoints.
4. You render the data in your Households Dashboard — charts, comparisons, and forecasts.

Unlike the Engagement Service, the Intelligence Service does **not** push data to your system. Instead, your application pulls processed data on demand through the API.

### Sections

{% content-ref url="/pages/KXyUIjmg1dsIYTL3vp32" %}
[Energy Statistics](/technical-integration/cloud-to-cloud-integration/intelligence-service-integration/energy-statistics.md)
{% endcontent-ref %}

{% content-ref url="/pages/KRu3pQ8mFyE9YDqn3TVo" %}
[Peer Comparison](/technical-integration/cloud-to-cloud-integration/intelligence-service-integration/peer-comparison.md)
{% endcontent-ref %}

{% content-ref url="/pages/fnI8ci3F28zBtpLzP9fO" %}
[Energy Forecast](/technical-integration/cloud-to-cloud-integration/intelligence-service-integration/energy-forecast.md)
{% endcontent-ref %}

{% content-ref url="/pages/6koxTdUHOnsalrJWc1ib" %}
[Households Dashboard](/technical-integration/cloud-to-cloud-integration/intelligence-service-integration/households-dashboard.md)
{% endcontent-ref %}

### Integration Checklist

* [ ] Obtain API credentials (`clientId`, `clientSecret`) from MOOST.
* [ ] Implement authentication (see Common Integration).
* [ ] Register your buildings with devices, location (`zip`, `geolocation`), and tariff settings.
* [ ] Begin sending events — at minimum `ENERGY_CONSUMPTION` and `ENERGY_GENERATION` (if applicable). For faster energy-statistics queries, also send daily aggregate `*_YESTERDAY` event types.
* [ ] Implement polling for the energy-statistics endpoints to populate your dashboard.
* [ ] Add peer comparison using the comparison endpoint with an appropriate category (`CONSUMPTION_CATEGORY`, `ELCOM`, or `GRID_POWER_CONSUMPTION_CLUSTER`).
* [ ] Integrate forecasts for forward-looking dashboard features.
* [ ] Use the MOOST admin frontend Household Detail → Dashboard tab as a reference implementation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.moost.io/technical-integration/cloud-to-cloud-integration/intelligence-service-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.