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

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

`GET /api/v1/insights/charges/driver-member-costs-report`

Required scope: `insights:read`

Returns charge insights for the given teamId (and optionally `teamMemberIds`) broken down by team member 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`
- `teamMemberIds` string, nullable — Filter to retrieve charges insights by the specified (comma-separated) list of `teamMemberId`
- `fromDate` string, date, required — Filter to retrieve charge insights created from date, we expect a 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 expect a 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`

Driver report for the given filter

- OffsetBasedResponse9
  - `data` ChargesInsightDriverMemberCostsReport[], required
    - `teamId` integer, required — Team ID used for this report
    - `teamMemberId` integer, required — Team Member ID of the Driver
    - `userId` integer, required — User ID of the Driver
    - `consumptions` ChargesInsightDriverMemberCostsReportDtoConsumption[], 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
      - `countryBreakdown` ChargesInsightDriverMemberCostsReportDtoConsumptionCountryBreakdown[], required — Breakdown of the charges by country
        - `countryCode` string, required — Two letter Country Code
        - `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
        - `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)