> ## Documentation Index
> Fetch the complete documentation index at: https://developers.podero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an Organisation's Devices Summary

> Whole-fleet device counts for the console Fleet screen in one call — the
server-side counterpart of the client folds over the full device list
(`fleetReal.ts::healthRows` / `deviceTypeShares` / `deviceSavingsLeg`):
health-tone counts, type-bucket shares, and per-savings-leg device counts to
sit beside `GET …/devices/savings?by=device_type`. Operational (non-soft-
deleted) devices only.

Available only for "admin" users.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/devices/summary
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/org/{org_id}/devices/summary:
    get:
      tags:
        - Devices
      summary: Get an Organisation's Devices Summary
      description: >-
        Whole-fleet device counts for the console Fleet screen in one call — the

        server-side counterpart of the client folds over the full device list

        (`fleetReal.ts::healthRows` / `deviceTypeShares` / `deviceSavingsLeg`):

        health-tone counts, type-bucket shares, and per-savings-leg device
        counts to

        sit beside `GET …/devices/savings?by=device_type`. Operational
        (non-soft-

        deleted) devices only.


        Available only for "admin" users.
      operationId: >-
        integrations_api_api_v2_organizations_devices_router_retrieve_devices_summary
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID of the user's organization
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID of the user's organization
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationDevicesSummaryOutput'
      security:
        - OAuth2: []
components:
  schemas:
    OrganizationDevicesSummaryOutput:
      description: >-
        Whole-fleet device counts over the org's operational (non-soft-deleted)
        devices.

        `health_tones` and `type_shares` each sum to the operational-device
        total;

        `savings_leg_counts` covers only devices with a savings leg (wallboxes
        and

        devices without a mapped type have none).
      properties:
        health_tones:
          $ref: '#/components/schemas/HealthToneCountsOutput'
        type_shares:
          $ref: '#/components/schemas/DeviceTypeShareCountsOutput'
        savings_leg_counts:
          $ref: '#/components/schemas/SavingsLegCountsOutput'
      required:
        - health_tones
        - type_shares
        - savings_leg_counts
      title: OrganizationDevicesSummaryOutput
      type: object
    HealthToneCountsOutput:
      description: >-
        `not_steered` is the muted management bucket — connected and reporting,
        but nobody is

        steering it — so it is disjoint from the three health severities, not a
        subset of them.
      properties:
        good:
          title: Good
          type: integer
        warning:
          title: Warning
          type: integer
        critical:
          title: Critical
          type: integer
        not_steered:
          title: Not Steered
          type: integer
      required:
        - good
        - warning
        - critical
        - not_steered
      title: HealthToneCountsOutput
      type: object
    DeviceTypeShareCountsOutput:
      properties:
        heat_pump:
          title: Heat Pump
          type: integer
        ev:
          title: Ev
          type: integer
        wallbox:
          title: Wallbox
          type: integer
        battery:
          title: Battery
          type: integer
        other:
          title: Other
          type: integer
      required:
        - heat_pump
        - ev
        - wallbox
        - battery
        - other
      title: DeviceTypeShareCountsOutput
      type: object
    SavingsLegCountsOutput:
      properties:
        heat_pump:
          title: Heat Pump
          type: integer
        electric_vehicle:
          title: Electric Vehicle
          type: integer
        inverter:
          title: Inverter
          type: integer
      required:
        - heat_pump
        - electric_vehicle
        - inverter
      title: SavingsLegCountsOutput
      type: object
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````