> ## 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.

# List standalone HEMS steering sessions for a wallbox



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/users/{user_id}/wallboxes/{wallbox_id}/hems-sessions
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}/users/{user_id}/wallboxes/{wallbox_id}/hems-sessions:
    get:
      tags:
        - Wallbox HEMS Sessions
      summary: List standalone HEMS steering sessions for a wallbox
      operationId: >-
        integrations_api_api_v2_organizations_users_wallboxes_hems_sessions_router_list_hems_sessions_endpoint
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID
        - in: path
          name: user_id
          schema:
            description: The user ID
            format: uuid
            title: User Id
            type: string
          required: true
          description: The user ID
        - in: path
          name: wallbox_id
          schema:
            description: The wallbox ID
            format: uuid
            title: Wallbox Id
            type: string
          required: true
          description: The wallbox ID
        - in: query
          name: from
          schema:
            description: Inclusive lower bound day (UTC, YYYY-MM-DD)
            format: date
            title: From
            type: string
          required: true
          description: Inclusive lower bound day (UTC, YYYY-MM-DD)
        - in: query
          name: to
          schema:
            description: Inclusive upper bound day (UTC, YYYY-MM-DD)
            format: date
            title: To
            type: string
          required: true
          description: Inclusive upper bound day (UTC, YYYY-MM-DD)
        - in: query
          name: limit
          schema:
            default: 50
            description: Page size (max 200)
            maximum: 200
            minimum: 1
            title: Limit
            type: integer
          required: false
          description: Page size (max 200)
        - in: query
          name: offset
          schema:
            default: 0
            description: Offset for pagination
            minimum: 0
            title: Offset
            type: integer
          required: false
          description: Offset for pagination
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HEMSSessionsListResponse'
      security:
        - OAuth2: []
components:
  schemas:
    HEMSSessionsListResponse:
      properties:
        total:
          title: Total
          type: integer
        items:
          items:
            $ref: '#/components/schemas/HEMSSessionItem'
          title: Items
          type: array
      required:
        - total
        - items
      title: HEMSSessionsListResponse
      type: object
    HEMSSessionItem:
      properties:
        id:
          title: Id
          type: integer
        ocpp_transaction_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Ocpp Transaction Id
        started_at:
          format: date-time
          title: Started At
          type: string
        ended_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Ended At
        final_hems_state:
          title: Final Hems State
          type: string
        outcome:
          anyOf:
            - $ref: '#/components/schemas/WBHEMSSessionOutcome'
            - type: 'null'
        energy_from_solar_kwh:
          anyOf:
            - type: number
            - type: 'null'
          title: Energy From Solar Kwh
        savings_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Savings Eur
        has_complete_price_coverage:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Complete Price Coverage
        commands_sent:
          title: Commands Sent
          type: integer
        commands_applied:
          title: Commands Applied
          type: integer
        commands_ineffective:
          title: Commands Ineffective
          type: integer
      required:
        - id
        - ocpp_transaction_id
        - started_at
        - ended_at
        - final_hems_state
        - outcome
        - energy_from_solar_kwh
        - savings_eur
        - has_complete_price_coverage
        - commands_sent
        - commands_applied
        - commands_ineffective
      title: HEMSSessionItem
      type: object
    WBHEMSSessionOutcome:
      description: >-
        Rolled-up outcome of one standalone wallbox HEMS session (SC-56).


        Mirrors the EV SessionOutcome idea at minimum-viable level: a single
        value

        an evaluator can read instead of the decision timeline.


        CHARGED_FROM_SOLAR    - at least one applied steering command delivered
        energy.

        NO_SURPLUS            - the loop ran but never saw enough surplus to
        start.

        STEERING_INEFFECTIVE  - commands dispatched but none verified as applied
                                (the Go-E silent no-op class — SC-55 verdicts).
        ABORTED               - exited without a clean finalize (eligibility
        flipped
                                off mid-charge, workflow terminated).
      enum:
        - charged_from_solar
        - no_surplus
        - steering_ineffective
        - aborted
      title: WBHEMSSessionOutcome
      type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````