---
title: "Get explanations"
method: GET
path: "/sites/{site_id}/explanations"
tags: ["Explanations"]
---

# Get explanations

`GET /sites/{site_id}/explanations`

## Request

- Base URL: `https://api.sitehive.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sitehive.co/sites/{site_id}/explanations`
- Auth: HTTP bearer

Returns a list of explanations for events where measurements exceeded predefined thresholds for each monitoring point.

## Path parameters

- `site_id` string, required

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time, required
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` Def3[], required
    - `startDate` string, date-time, required: ISO 8601 UTC timestamp indicating when the event or exceedance started.
    - `endDate` string, date-time, required: ISO 8601 UTC timestamp indicating when the event or exceedance ended.
    - `category` object, required: Optional categorization of the event or exceedance."
      - `status` string, required: Status of the event, e.g., 'Reportable' or 'Non Reportable'.
      - `classification` string, required: Classification or type of event, e.g., 'Landscaping work'.
    - `exceedances` object[], required: List of monitoring point and rule that are associated with this explanation.
      - `monitoringPointId` string, required: Unique identifier of the monitoring point linked to this explanation.
      - `ruleId` string, required: Unique identifier of the rule that was triggered.
    - `notes` string, required: Notes providing context or details about the explanation.
  - `pagination` Def5, required: Basic pagination information for a list response.
    - `offset` integer, required: The starting index of the returned items in the full dataset.
    - `limit` integer, required: Maximum number of items returned in this response.
    - `hasNext` boolean, required: True if another page is available, false on the last page.

## Other responses

- `401`: Returned when a request attempts to access a protected resource without providing authentication credentials.
- `403`: Returned when an authenticated request is denied due to insufficient permissions or access rights.

---

[API](https://skmtc.dev/sitehive/apis/sitehive-public-api.md) - [All operations](https://skmtc.dev/sitehive/apis/sitehive-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sitehive/apis/sitehive-public-api/revisions/a547c1378f9b?raw)