> ## 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 completed charging sessions across a user's EVs and wallboxes



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/users/{user_id}/charging-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}/charging-sessions:
    get:
      tags:
        - User Charging Sessions
      summary: List completed charging sessions across a user's EVs and wallboxes
      operationId: >-
        integrations_api_api_v2_organizations_users_charging_sessions_router_list_charging_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: 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
        - in: query
          name: source
          schema:
            anyOf:
              - $ref: '#/components/schemas/ChargingSessionSource'
              - type: 'null'
            description: Optional filter to one source
          required: false
          description: Optional filter to one source
        - in: query
          name: include_hidden
          schema:
            default: false
            description: >-
              Include sessions flagged hidden by the classifier (EV rows only;
              wallbox sessions have no hidden concept). Back-office/debugging
              use.
            title: Include Hidden
            type: boolean
          required: false
          description: >-
            Include sessions flagged hidden by the classifier (EV rows only;
            wallbox sessions have no hidden concept). Back-office/debugging use.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChargingSessionsListResponse'
      security:
        - OAuth2: []
components:
  schemas:
    ChargingSessionSource:
      enum:
        - ev
        - wallbox
      title: ChargingSessionSource
      type: string
    ChargingSessionsListResponse:
      properties:
        total:
          title: Total
          type: integer
        items:
          items:
            $ref: '#/components/schemas/ChargingSessionItem'
          title: Items
          type: array
      required:
        - total
        - items
      title: ChargingSessionsListResponse
      type: object
    ChargingSessionItem:
      properties:
        id:
          description: >-
            Opaque prefix-typed id: `ev_{uuid}` or `wb_{int}`. Do not parse —
            use `source`.
          title: Id
          type: string
        source:
          $ref: '#/components/schemas/ChargingSessionSource'
        started_at:
          format: date-time
          title: Started At
          type: string
        ended_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Ended At
        is_active:
          title: Is Active
          type: boolean
        electric_vehicle_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Electric Vehicle Id
        wallbox_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Wallbox Id
        ocpp_transaction_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Ocpp Transaction Id
        outcome:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Raw union of the two families' outcome vocabularies, served without
            remapping. One of: aborted, already_at_target, autonomous_charge,
            boosted, charged_from_solar, commands_failed, ev_not_found,
            hems_only_mode, immediate_start, in_progress,
            insufficient_price_coverage, no_battery_capacity, no_surplus,
            not_at_home, not_authenticated, oem_not_capable, oem_reported_full,
            optimized, other, smart_optimization_disabled, spot_no_charge,
            spot_optimized, steering_blocked, steering_ineffective,
            steering_not_effective, target_not_reachable, unknown,
            user_unplugged_early, vehicle_offboarded.
          title: Outcome
        final_hems_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Final Hems State
        hems_activated:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Hems Activated
        is_at_home:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Is At Home
        desired_steering:
          anyOf:
            - type: string
            - type: 'null'
          title: Desired Steering
        optimization_skip_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Optimization Skip Reason
        energy_delivered_kwh:
          anyOf:
            - type: number
            - type: 'null'
          title: Energy Delivered Kwh
        energy_from_solar_kwh:
          anyOf:
            - type: number
            - type: 'null'
          title: Energy From Solar Kwh
        energy_from_grid_kwh:
          anyOf:
            - type: number
            - type: 'null'
          title: Energy From Grid Kwh
        avg_charge_power_kw:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Charge Power Kw
        peak_charge_power_kw:
          anyOf:
            - type: number
            - type: 'null'
          title: Peak Charge Power Kw
        initial_soc_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Initial Soc Pct
        final_soc_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Final Soc Pct
        target_soc_pct:
          anyOf:
            - type: number
            - type: 'null'
          title: Target Soc Pct
        soc_source:
          anyOf:
            - type: string
            - type: 'null'
          title: Soc Source
        charge_deadline:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Charge Deadline
        target_reachable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Target Reachable
        reachable_soc_pct:
          anyOf:
            - type: integer
            - type: 'null'
          title: Reachable Soc Pct
        optimized_cost_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Optimized Cost Eur
        unoptimized_cost_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Unoptimized Cost Eur
        spot_savings_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Spot Savings Eur
        solar_savings_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Solar Savings Eur
        total_savings_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Total Savings Eur
        projected_savings_eur:
          anyOf:
            - type: number
            - type: 'null'
          title: Projected Savings Eur
        has_complete_price_coverage:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Complete Price Coverage
        commands_sent:
          anyOf:
            - type: integer
            - type: 'null'
          title: Commands Sent
        commands_applied:
          anyOf:
            - type: integer
            - type: 'null'
          title: Commands Applied
        commands_ineffective:
          anyOf:
            - type: integer
            - type: 'null'
          title: Commands Ineffective
        commands_rejected:
          anyOf:
            - type: integer
            - type: 'null'
          title: Commands Rejected
        steering_was_effective:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Steering Was Effective
        dominant_command_error:
          anyOf:
            - type: string
            - type: 'null'
          title: Dominant Command Error
        was_boosted:
          title: Was Boosted
          type: boolean
        boost_triggered_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Boost Triggered At
        boost_ended_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Boost Ended At
        boost_end_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Boost End Reason
        desired_charging_start_time:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Desired Charging Start Time
        desired_charging_end_time:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Desired Charging End Time
      required:
        - id
        - source
        - started_at
        - ended_at
        - is_active
        - electric_vehicle_id
        - wallbox_id
        - ocpp_transaction_id
        - final_hems_state
        - hems_activated
        - is_at_home
        - desired_steering
        - optimization_skip_reason
        - energy_delivered_kwh
        - energy_from_solar_kwh
        - energy_from_grid_kwh
        - avg_charge_power_kw
        - peak_charge_power_kw
        - initial_soc_pct
        - final_soc_pct
        - target_soc_pct
        - soc_source
        - charge_deadline
        - target_reachable
        - reachable_soc_pct
        - optimized_cost_eur
        - unoptimized_cost_eur
        - spot_savings_eur
        - solar_savings_eur
        - total_savings_eur
        - projected_savings_eur
        - has_complete_price_coverage
        - commands_sent
        - commands_applied
        - commands_ineffective
        - commands_rejected
        - steering_was_effective
        - dominant_command_error
        - was_boosted
        - boost_triggered_at
        - boost_ended_at
        - boost_end_reason
        - desired_charging_start_time
        - desired_charging_end_time
      title: ChargingSessionItem
      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: {}

````