> ## 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 for an electric vehicle ## OpenAPI ````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{electric_vehicle_id}/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}/electric-vehicles/{electric_vehicle_id}/sessions: get: tags: - Electric Vehicle Sessions summary: List completed charging sessions for an electric vehicle operationId: >- integrations_api_api_v2_organizations_users_electric_vehicles_sessions_router_list_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: electric_vehicle_id schema: description: The electric vehicle ID format: uuid title: Electric Vehicle Id type: string required: true description: The electric vehicle 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: include_hidden schema: default: false description: >- Include sessions flagged hidden by the classifier (e.g. sub-5-minute plug blips). Back-office/debugging use. title: Include Hidden type: boolean required: false description: >- Include sessions flagged hidden by the classifier (e.g. sub-5-minute plug blips). Back-office/debugging use. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SessionsListResponse' security: - OAuth2: [] components: schemas: SessionsListResponse: properties: total: title: Total type: integer items: items: $ref: '#/components/schemas/SessionItem' title: Items type: array required: - total - items title: SessionsListResponse type: object SessionItem: properties: id: format: uuid title: Id type: string plug_in_time: format: date-time title: Plug In Time type: string unplug_time: anyOf: - format: date-time type: string - type: 'null' title: Unplug Time inferred_session_end: anyOf: - format: date-time type: string - type: 'null' title: Inferred Session End 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 charge_deadline: anyOf: - format: date-time type: string - type: 'null' title: Charge Deadline target_soc_pct: anyOf: - type: number - type: 'null' title: Target Soc Pct initial_soc_pct: anyOf: - type: number - type: 'null' title: Initial Soc Pct final_soc_pct: anyOf: - type: number - type: 'null' title: Final Soc Pct energy_charged_kwh: anyOf: - type: number - type: 'null' title: Energy Charged 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 actual_cost_eur: anyOf: - type: number - type: 'null' title: Actual Cost Eur expected_savings_eur: anyOf: - type: number - type: 'null' title: Expected Savings Eur actual_savings_eur: anyOf: - type: number - type: 'null' title: Actual Savings Eur is_at_home: title: Is At Home type: boolean session_outcome: $ref: '#/components/schemas/SessionOutcome' is_hidden: default: false title: Is Hidden type: boolean hidden_reason: anyOf: - $ref: '#/components/schemas/HiddenReason' - type: 'null' target_reachable: anyOf: - type: boolean - type: 'null' title: Target Reachable reachable_soc_pct: anyOf: - type: integer - type: 'null' title: Reachable Soc Pct required: - id - plug_in_time - unplug_time - inferred_session_end - desired_charging_start_time - desired_charging_end_time - charge_deadline - target_soc_pct - initial_soc_pct - final_soc_pct - energy_charged_kwh - avg_charge_power_kw - peak_charge_power_kw - actual_cost_eur - expected_savings_eur - actual_savings_eur - is_at_home - session_outcome title: SessionItem type: object SessionOutcome: enum: - not_at_home - not_authenticated - smart_optimization_disabled - no_battery_capacity - already_at_target - ev_not_found - hems_only_mode - immediate_start - oem_not_capable - insufficient_price_coverage - user_unplugged_early - commands_failed - oem_reported_full - boosted - in_progress - optimized - other - unknown title: SessionOutcome type: string HiddenReason: description: >- Public mirror of the internal `session_visibility.HiddenReason`. Drift guard below ensures we stay value-for-value in sync without leaking the deep internal import path into the response schema. enum: - short_duration title: HiddenReason 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: {} ````