---
title: "Chargers"
method: GET
path: "/api/chargers"
tags: ["Charger"]
---

# Chargers

`GET /api/chargers`

Retrieves all chargers accessible by the current user, matching the provided filters.  
By default, returns the first 50 items. Use `pageIndex` for pagination or adjust `pageSize` (max: 100).

## Query parameters

- `Roles` 0 | 1 | 2 | 4 | 8 | 15 | 16 | 32 | 64 | 128 | 256 — 0 = None 1 = User 2 = Owner 4 = Maintainer 8 = Administrator 15 = Any 16 = Onboarding 32 = DeviceAdministrator 64 = PartnerAdministrator 128 = Technical 256 = InternalData
- `DeviceType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 — 0 = Unknown 1 = Smart 2 = Portable 3 = HomeApm 4 = Apollo 5 = OtherApm 6 = GenericApm 7 = HanApm 8 = TicApm
- `InstallationType` 0 | 1 — 0 = Pro 1 = Smart
- `InstallationId` string, uuid
- `NameFilter` string
- `ReturnIdNameOnly` boolean
- `SortProperty` string
- `SortDescending` boolean
- `PageSize` integer
- `PageIndex` integer
- `IncludeDisabled` boolean
- `Exclude` string[]
- `PageInfoOnly` boolean

## Response `200`

OK

- ChargerListModelPagedData
  - `pages` integer
  - `data` ChargerListModel[], nullable
    - `id` string, uuid — Get the unique identifier of the charge point.
    - `mid` string, nullable — <strong>This property is obsolete and is scheduled for removal,</strong> please use `DeviceId` instead.
    - `deviceId` string, nullable — Get the deviceId (serialNo) of the charging stations used with the charge point.
    - `serialNo` string, nullable — <strong>This property is obsolete and is scheduled for removal,</strong> please use `Name` instead.
    - `name` string, nullable — Get the name of the charge point.
    - `createdOnDate` string, date-time, nullable — Get the date and time the installation was created.
    - `circuitId` string, uuid, nullable — Get the unique identifier the charge point is installed in.
    - `active` boolean, nullable — Get a value indicating whether the charge point is active.
    - `currentUserRoles` 0 | 1 | 2 | 4 | 8 | 15 | 16 | 32 | 64 | 128 | 256 — 0 = None 1 = User 2 = Owner 4 = Maintainer 8 = Administrator 15 = Any 16 = Onboarding 32 = DeviceAdministrator 64 = PartnerAdministrator 128 = Technical 256 = InternalData
    - `pin` string, nullable — Get the charger PIN code. This will only be provided if your user is system owner for the charge point.
    - `templateId` string, uuid, nullable — Get the unique identifier of the chargers firmware template.
    - `propertyOcppUrl` string, nullable
    - `propertyOcppPassword` string, nullable
    - `propertyPinOfflinePhase` boolean, nullable
    - `propertyAuthenticationDisabled` boolean, nullable
    - `hasSessions` boolean, nullable
    - `propertyOfflinePhaseOverride` 0 | 1 | 2 | 4 | 7 — 0 = None 1 = Phase_1 2 = Phase_2 4 = Phase_3 7 = All
    - `propertyOfflineCurrentOverride` number, double, nullable
    - `propertyOcppVerboseLogUntil` string, date-time, nullable
    - `propertyOcppDefaultIdTag` string, nullable
    - `propertyOcppWebSocketPingInterval` integer, nullable
    - `propertyPrioritizedCurrent` number, double, nullable
    - `propertyPrioritizedPhases` 1 | 3 — 1 = One 3 = Three
    - `propertyMaxSinglePhaseChargeCurrent` number, double, nullable
    - `propertyOcppAvailability` integer, nullable
    - `propertyOcppOfflineListVersion` integer, nullable
    - `signedMeterValueKwh` number, double, nullable
    - `signedMeterValue` string, nullable
    - `signedSessionEichrecht` string, nullable
    - `deviceType` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 — 0 = Unknown 1 = Smart 2 = Portable 3 = HomeApm 4 = Apollo 5 = OtherApm 6 = GenericApm 7 = HanApm 8 = TicApm
    - `installationName` string, nullable
    - `installationId` string, uuid, nullable
    - `authenticationType` 0 | 1 | 2 | 3 — 0 = Native 1 = WebHooks 2 = Ocpp 3 = OcppNative
    - `isAuthorizationRequired` boolean, nullable
    - `currentUserHasServiceLevelTechnicalReadAccess` boolean, nullable — Service-level entitlement flag (not a regular role/permission): `true` when the current user is entitled to TechnicalRead (debug-log) access on this charger. The entitlement is granted through a user group that carries the Zaptec.ZapCloud.Domain.Models.ServiceLevel.TechnicalRead service level and has an effective Owner permission on the charger (including inherited and wildcard targets). Used by the frontend to decide whether to surface relevant UI. `null` unless explicitly requested (opt-in).
    - `operatingMode` 0 | 1 | 2 | 3 | 5 — 0 = Unknown 1 = Disconnected 2 = Connected_Requesting 3 = Connected_Charging 5 = Connected_Finished
    - `isOnline` boolean
    - `warnings` string, nullable
  - `message` string, nullable

## Other responses

- `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)