> ## 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 the currently active charging session for an electric vehicle > Returns the active session wrapped as `{ "session": ... }`. When no session is active, returns 200 with `{ "session": null }` instead of 404 so clients can poll without exception handling. ## 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/current 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/current: get: tags: - Electric Vehicle Sessions summary: Get the currently active charging session for an electric vehicle description: >- Returns the active session wrapped as `{ "session": ... }`. When no session is active, returns 200 with `{ "session": null }` instead of 404 so clients can poll without exception handling. operationId: >- integrations_api_api_v2_organizations_users_electric_vehicles_sessions_router_get_current_session_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: include_hidden schema: default: false description: >- Include the active session even if flagged hidden. Back-office/debugging use. title: Include Hidden type: boolean required: false description: >- Include the active session even if flagged hidden. Back-office/debugging use. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/CurrentSessionResponse' security: - OAuth2: [] components: schemas: CurrentSessionResponse: properties: session: anyOf: - $ref: '#/components/schemas/SessionItem' - type: 'null' required: - session title: CurrentSessionResponse 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: {} ````