---
title: "Retrieve insights about charges broken down by charge auth token and member cost groups of a team."
method: GET
path: "/api/v1/insights/charges/charge-auth-token-report"
tags: ["Insights"]
---

# Retrieve insights about charges broken down by charge auth token and member cost groups of a team.

`GET /api/v1/insights/charges/charge-auth-token-report`

Required scope: `insights:read`

Returns charge insights for the given teamId (and optionally `chargeAuthTokenIds`) broken down by charge auth token and the member cost groups.
Takes only charges into consideration that were paid for by the provided `teamId`.

Note: Any values related to money are in the teams' currency. You can fetch them from `GET /api/v1/teams/{teamId}`

## Query parameters

- `page` integer
- `perPage` integer
- `teamId` integer, required — Filter to retrieve charges insights by the specified `teamId`
- `fromDate` string, date, required — Filter to retrieve charge insights created from date, we expecta date in UTC and ISO8601 (YYYY-MM-DD'T'HH:MM:SS'Z')</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, we expecta date in UTC and ISO8601 (YYYY-MM-DD'T'HH:MM:SS'Z')</br>The maximum gap between from and to data cannot be longer than 31 days
- `datesFilteredBy` 'charge-transaction' | 'wallet-transaction', nullable — Use this to determine if the report should be filtered based on completion dates of charges or wallet transactions.</br></br>Accepted values:</br>- `charge-transaction`: Generates report based on charges' `completedAt`. Default.- `wallet-transaction`: Generates report based on wallet transactions' `completedAt`. Will not include any charges without wallet transactions.

## Response `200`

Charge Auth Token report for the given filter

- OffsetBasedResponse10
  - `data` ChargesInsightByChargeAuthTokenReportDto[], required
    - `id` integer — The id of the charge auth token
    - `identifier` string, required — The identifier of the charge auth token, Note: without prefix e.g `VID:`
    - `type` 'vehicleId' | 'rfid', required — The method type used for this charge auth token
    - `consumptions` ChargesInsightByChargeAuthTokenReportDtoConsumption[], required — Charge consumptions grouped by `chargeType`
      - `chargeType` string, required — Defines the type of charge, ie. if it was a sponsored or public charge. definitions: * `sponsored` - Charges that have been sponsored. * `team-operator` - Charges that belong to Charge Points of the same operator as paying team operator. * `public` - Any charge that was paid for by this team that does not match the other cases. Note that more chargeTypes might be added in the future. Make sure to handle this gracefully.
      - `totalSessions` integer, required — Number of charging sessions
      - `totalKwh` number, double, required — Sum of all Kwh consumed
      - `totalNetPrice` number, double, required — Sum of all charge net prices
      - `totalVat` number, double, required — Sum of all charge vat amounts
      - `totalGrossPrice` number, double, required — Sum of all charge gross prices
      - `memberCostGroupId` integer, nullable — The ID of the Member Cost Group applied to this charges, or Null if none
      - `memberCostGroupName` string, nullable — The name of the Member Cost Group applied to this charges, or Null if none
      - `memberCostGroupPrice` number, double, nullable — Sum of all charge costs in the Member Cost Group currency, or Null if none
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Unauthorized access
- `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)