# Charging Sessions

Endpoints related to records of charging.

## List charging sub sessions

 - [GET /charging_sub_sessions](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/get-charging_sub_sessions.md): List all charging sub sessions visible to the authenticated client.

## Retrieve a charging sub-session

 - [GET /charging_sub_sessions/{charging_sub_session_id}](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/get-charging_sub_sessions-charging_sub_session_id.md): Retrieve a specific charging sub-session, representing a period of charging in a single mode.

## Retrieve periodic energy usage intervals for a charging sub-session

 - [GET /charging_sub_sessions/{charging_sub_session_id}/energy_usage](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/get-charging_sub_sessions-charging_sub_session_id-energy_usage.md): Retrieve periodic energy usage intervals for a specific charging sub-session.

If you are looking for intervals that cover the whole time energy is being delivered (which are therefore of irregular length) use the merge_consecutive_intervals query parameter.

## Retrieve schedules for a charging sub-session

 - [GET /charging_sub_sessions/{charging_sub_session_id}/schedules](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/get-charging_sub_sessions-charging_sub_session_id-schedules.md): Retrieve schedules for a specific charging sub-session.

Schedules represent charging instructions for a charging session. Each schedule specifies a current (in milliamps) and a time period during which that current should be applied.

## Retrieve schedule plans for a charging sub-session

 - [GET /charging_sub_sessions/{charging_sub_session_id}/schedule_plans](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/get-charging_sub_sessions-charging_sub_session_id-schedule_plans.md): Retrieve schedule plans for a specific charging sub-session.

Schedule plans represent the charging plan parameters used to generate schedules for a charging session. Each plan contains information about the ready-by time, charging requirements, and constraints that were used to create the charging schedule.

## List dispatcher logs

 - [GET /dispatcher_logs](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/get-dispatcher_logs.md): List all dispatcher logs for a charging session. These logs record Dispatch Command attempts to EVSEs or Vehicles.

## Charging sub-session created

 - [POST charging_sub_session.created](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/paths/charging_sub_session.created/post.md): A charging sub-session is created, representing a period of charging in a single mode.

## Charging sub-session ended

 - [POST charging_sub_session.ended](https://developers.ev.energy/ev.energy-api-v2/charging-sessions/paths/charging_sub_session.ended/post.md): A charging sub-session has ended, representing a period of charging in a single mode.