---
title: "Usage report"
method: POST
path: "/api/chargehistory/installationreport"
tags: ["ChargeHistory"]
---

# Usage report

`POST /api/chargehistory/installationreport`

Retrieves a usage report based on the provided filters (requires installation owner permissions).

## Request body

- InstallationChargeHistoryModel
  - `fromDate` string, date-time
  - `endDate` string, date-time
  - `installationId` string, uuid, nullable
  - `userIds` string[], nullable
  - `chargerIds` string[], nullable
  - `groupBy` 0 | 1 | 2 — 0 = User 1 = Charger 2 = ChargeCardName
  - `reportFormat` 0 | 1 — 0 = Summary 1 = Detailed

## Response `200`

OK

- CustomTotalChargerReportModel
  - `installationName` string, nullable
  - `installationAddress` string, nullable
  - `installationZipCode` string, nullable
  - `installationCity` string, nullable
  - `installationTimeZone` string, nullable
  - `groupedBy` string, nullable
  - `fromdate` string, date-time
  - `enddate` string, date-time
  - `totalUserChargerReportModel` TotalUserChargerReportModel[], nullable
    - `groupAsString` string, nullable
    - `userDetails` TotalUserChargerReportUserModel
      - `id` string, uuid
      - `email` string, nullable
      - `fullName` string, nullable
    - `totalChargeSessionCount` number, double
    - `totalChargeSessionEnergy` number, double
    - `totalChargeSessionDuration` number, double

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/zaptec/apis/zaptec-api.md) · [All operations](https://skmtc.dev/zaptec/apis/zaptec-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zaptec/zaptec-api/revisions/6892fe4b8df5/schema)