Endpoints related to records of charging. See [Understanding charging data](docs/understanding/charging_sessions.md) for how charging sessions (plug-in episodes), charging sub-sessions (per-mode segments) and energy usage intervals (actual energy delivery) relate to each other.
ev.energy Charging Sessions API is one of 25 APIs that ev.energy publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Charging Sessions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.
This API exposes
14 operations
across 14 paths,
and defines 45 schemas.
It is described by OpenAPI 3.2.0, at version 2.0.
Requests are made against 2 base URLs: https://api.ev.energy/v2, https://api-staging.ev.energy/v2.
14 operations14 paths45 schemas11 GET3 POST
Metadata
The identity and technical contract details declared by the specification.
ev.energy Charging Sessions API declares
1 security scheme
for authenticating requests.
It supports OAuth 2.0 (oauth2) using the clientCredentials and authorizationCode flows, exposing 35 scopes.
By default, every request must be authenticated.
Paths & Operations 14
Across 14 paths, the API surfaces 14 operations — 11 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.
Charging Sessions 14
Endpoints related to records of charging. See [Understanding charging data](docs/understanding/chargingsessions.md) for how charging sessions (plug-in episodes), charging sub-sess…
The contract defines 45 schemas that model the data the API accepts and returns. The most detailed are ChargingSubSession (36 properties), ChargingSubSessionAssessmentMetrics (27 properties), VehicleStatusLog (19 properties), EVSEStatusLog (18 properties). Each schema is shown below with its type and property counts.
ChargingSubSessionAssessment
object
Performance assessment for a completed charging sub-session.
9 properties
Supplier
object
An energy company who supplies electricity tariffs.
5 properties4 required
GridFeed
object
A grid feed representing a source of grid signal data used for smart charging decisions.
5 properties5 required
CarbonFeed
object
A carbon feed representing a source of carbon intensity data for a specific region or grid.
3 properties3 required
ChargingSubSessionAssessmentRatings
object
RAG (Red/Amber/Green) quality ratings for assessment metrics. Includes an overall quality rating.
CTClamp
object
A CT (Current Transformer) clamp used to measure grid current, typically for solar charging logic.
4 properties
Times
object
Defines a period of time.
2 properties
ChargingSession
object
Represents a single physical plug-in episode (plug in → unplug). A session may contain multiple charging sub-sessions if the charging mode changed while the ve…
7 properties3 required
DailyPrices
object
Information about the tariff's prices for different parts of the day.
3 properties1 required
Tariff
Note: dailyprices and type are only available under contract. Please reach out to your account manager to find out more.
EVSESite
object
Represents a place with one or more EVSEs installed which can be accessed by multiple users.
6 properties4 required
Schedules
object
3 properties
VehicleStatusLog
object
Records the state of a Vehicle at a particular point in time.
19 properties
EVSEModel
object
A resource representing a model of EVSEs.
6 properties3 required
Location
object
Location model for charging locations. Address validation: Address fields are optional as a group, but each field independently triggers the requirement. If an…
9 properties
ChargingSubSession
object
Represents a period within a charging session (one plug-in episode) when the same charging mode was active. Begins either when a vehicle is plugged in or when…
36 properties15 required
SchedulePlan
object
A schedule plan containing the parameters used to generate charging schedules.
14 properties
Vehicle
object
A resource representing a single, physical electric vehicle.
14 properties10 required
ChargingSubSessionEndedWebhook
object
Webhook payload delivered when a charging sub-session ends.
3 properties3 required
ChargingSessionFlag
object
2 properties2 required
ChargingSubSessionAssessmentMetrics
object
Performance quality metrics for a charging session assessment. All fields are nullable.
27 properties
DispatcherLog
object
Records when a Dispatch Command was sent to an EVSE or Vehicle.
7 properties
UsageInterval
object
8 properties
CountryCode
string
ISO 3166-1 2 letter Country Codes.
ScheduleInterval
object
A schedule interval represents a charging instruction for a specific time period within a charging session. It specifies the charging current (in milliamps) th…
6 properties
EVSEStatusLog
object
Records the state of an EVSE at a particular point in time.
18 properties
LocationDetail
Extra fields only included when a single location is requested but omitted when locations are listed.
PriceSummary
object
A single price for a certain time range.
2 properties
VehicleMake
object
A resource representing a vehicle manufacturer.
8 properties6 required
VehicleModel
object
A resource representing a model of vehicle.
8 properties5 required
EnergyDeliveredByPrice
object
2 properties
VehicleTrim
object
A resource representing a "trim level" of a particular vehicle model, which captures a specific set of features.
6 properties4 required
RFC9457ProblemDetail
object
6 properties2 required
Notification
object
Something that the user should be informed about.
13 properties11 required
Price
object
A price for a specific time interval.
3 properties3 required
EVSE
object
A resource that represents a single, physical piece of hardware for supplying electricity to an electric vehicle.
11 properties3 required
ChargingSubSessionDebugMetadata
object
Session-level diagnostic information for a charging sub-session.
9 properties9 required
SchedulePlans
object
3 properties
TariffBase
object
Core tariff properties shared by Tariff and expanded schedulertariff. Note: dailyprices and type are only available under contract. Please reach out to your ac…
13 properties5 required
ChargingSubSessionFlags
object
3 properties3 required
User
object
A resource that represents an individual user in the ev.energy system.
9 properties2 required
EnergyUsage
object
Detailed energy usage for a charging sub-session, reported as a list of intervals recording when energy was actually delivered to the vehicle and how much. Use…
5 properties
ChargingSubSessionCreatedWebhook
object
Webhook payload delivered when a charging sub-session is created.
3 properties3 required
LatLong
object
Coordinates model used for locations.
2 properties2 required
EVSEMake
object
A resource representing a manufacturer of EVSEs.
8 properties3 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of ev.energy Charging Sessions API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
