How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ev.energy Programs API

Endpoints related to incentivised charging programs.

ev.energy Programs 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 Programs. 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 13 operations across 13 paths, and defines 10 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.

13 operations 13 paths 10 schemas 9 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0
Base URL
https://api.ev.energy/v2
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

ev.energy Programs 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 13

Across 13 paths, the API surfaces 13 operations — 9 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Programs 13

Endpoints related to incentivised charging programs.

GET
/programs/{program_id}/vehicle_compatibility
List vehicle compatibility for a program
get-programs-program_id-vehicle_compatibility 4 params → 200400401403404406429
GET
/programs
List programs
get-programs 5 params → 200400401403429
GET
/programs/{program_id}
Retrieve a program
get-programs-program_id 2 params → 200400401403404429
GET
/incentive_schemes
List incentive schemes
get-incentive_schemes 1 param → 200400401403429
POST
/programs/{program_id}/user_verification
Verify user
post-programs-user-verification 3 params body → 201400401403404406429
POST
/programs/{program_id}/join
Join program
post-programs-program_id-join 3 params → 201400401403404406429
GET
/programs/{program_id}/tiers
List program tiers
get-programs-program_id-tiers 6 params → 200400401404406429
GET
/programs/{program_id}/tiers/{tier_id}
Retrieve a program tier
get-programs-program_id-tiers-tier_id 4 params → 200400404406429
GET
/programs/{program_id}/participation_agreement_versions
List participation agreement versions
get-programs-program_id-participation_agreement_versions 5 params → 200400404406429
GET
/programs/{program_id}/participation_agreement_versions/{participation_agreement_version_id}
Retrieve a participation agreement version
get-programs-program_id-participation_agreement_versions-id 3 params → 200400404406429
GET
/programs/{program_id}/participation_agreement_versions/current
Retrieve the currently active participation agreement version
get-programs-program_id-participation_agreement_versions-current 2 params → 200400404406429
POST
/programs/{program_id}/participation_agreement_versions/{participation_agreement_version_id}/accept
Accept a participation agreement version
post-programs-program_id-participation_agreement_versions-id-accept 3 params body → 201400401403404406429
POST
/programs/{program_id}/post-enrollment-verification
Post-enrollment verification
post-programs-post-enrollment-verification 3 params body → 201400401403404406429

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Notification (13 properties), ProgramTier (11 properties), VehicleModel (8 properties), VehicleMake (8 properties). Each schema is shown below with its type and property counts.

RFC9457ProblemDetail
object
6 properties 2 required
Notification
object
Something that the user should be informed about.
13 properties 11 required
ParticipationAgreementVersion
object
A version of a Program's Participation Agreement. Programs have a single Participation Agreement with versioned content; users accept a version via POST .../{i…
6 properties
ProgramTier
object
11 properties
CountryCode
string
ISO 3166-1 2 letter Country Codes.
ProgramVehicleCompatibility
object
A vehicle compatibility record indicating whether a particular vehicle model is supported for smart charging.
6 properties
VehicleMake
object
A resource representing a vehicle manufacturer.
8 properties 6 required
VehicleModel
object
A resource representing a model of vehicle.
8 properties 5 required
IncentiveScheme
object
Incentive Schemes define a set of rules for how an elgible User can earn monetary Incentives.
5 properties
Program
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ev-energy-programs-api-openapi.yml Raw ↑

Other APIs ev.energy publishes across the network.

ev.energy Auth API
ev.energy Boundary Meters API
ev.energy Carbon API
ev.energy Charging Sessions API
ev.energy CT Clamps API
ev.energy EVS Es API
ev.energy Grid API
ev.energy HEM Systems API
ev.energy Home Batteries API
ev.energy Notifications API
ev.energy Rebates API
ev.energy Reference Data API
Where this information came from

This is an independent, third-party profile of ev.energy Programs 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.