---
title: "Retrieve insights about charges."
method: GET
path: "/api/v1/charges/insights"
tags: ["Charges Insights"]
deprecated: true
---

# Retrieve insights about charges.

`GET /api/v1/charges/insights`

> **Deprecated.**

Required scope: `charge-transactions:read`.
**Deprecated, use `/insights/charges/driver-report` and `/insights/charges/charger-report` instead.**

## Query parameters

- `fromDate` string, date, required — Filter to retrieve charge insights created from date (YYYY-MM-DD), we expect a date in UTC</br>The maximum gap between from and to data cannot be longer than 31 days
- `toDate` string, date, required — Filter to retrieve charge insights created to date (YYYY-MM-DD), we expect a date in UTC</br>The maximum gap between from and to data cannot be longer than 31 days
- `teamId` integer, nullable — Filter to retrieve charges insights by the specified `teamId`
- `chargePointId` integer, nullable — Filter to retrieve charges insights by the specified `chargePointId`
- `siteId` integer, nullable — Filter to retrieve charges insights by the specified `siteId`
- `teamMemberId` integer, nullable — Filter to retrieve charges insights by the specified `teamMemberId`

## Response `200`

Charge insights for the given filter

- ChargesInsight
  - `type` 'completed-charges-insights' | 'unknown', required — Enumerate the various types of charges insights
  - `fromDate` string, date, required — Indicates the starting period (`fromDate`) used calculate the insights, format (YYYY-MM-DD)</br></br>*Note*: The date will be always in UTC
  - `toDate` string, date, required — Indicates the end period (`toDate`) used calculate the insights, format (YYYY-MM-DD), always in UCT</br></br>*Note*: The date will be always in UTC
  - `title` string, required — The title for for this charge insight
  - `operator` Operator, required
    - `id` integer — ID of the operator
    - `name` string, required — Name of operator
    - `identifier` string, required — Identifier of operator
    - `partnerId` integer, nullable — Id of the partner
    - `vatNumber` string, nullable — VAT number
  - `currency` Currency1, required
    - `identifier` string, required — Currency identifier, e.g. dkk
    - `name` string, required — Readable name of currency
    - `decimals` integer — Number of decimals for this currency
  - `insights` ChargesInsightEntry[], required — The compilation of insights entries composing this charge insight
    - `type` 'total-completed-sponsored-charges' | 'total-completed-operator-charges' | 'total-completed-external-charges' | 'total-completed-charges' | 'unknown', required — Enumerate the various types of charge insights
    - `summary` ChargesInsightSummary, required
      - `totalKwh` number, double, required — The total kWh charged for this entry
      - `totalPrice` integer, required — The total price for this entry
      - `totalCost` integer, required — The total cost for this entry
      - `totalSessions` integer, required — The total sessions for this entry

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)