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 Regions API

Geographic regions and region groups used for program eligibility and tariffs.

ev.energy Regions 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 Regions. 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 7 operations across 5 paths, and defines 12 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.

7 operations 5 paths 12 schemas 4 GET3 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 Regions 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 7

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

Regions 7

Geographic regions and region groups used for program eligibility and tariffs.

GET
/regions
List regions
get-regions 9 params → 200400401403406429
POST
/regions
Create region
post-regions 1 param body → 201400401403406409413422
GET
/regions/{region_id}
Retrieve region
get-regions-region_id 2 params → 200400401403404406429
GET
/region_groups
List region groups
get-region_groups 5 params → 200400401403406429
POST
/region_groups
Create region group
post-region_groups 1 param body → 201400401403406409413422
GET
/region_groups/{region_group_id}
Retrieve region group
get-region_groups-region_group_id 2 params → 200400401403404406429
POST
/region_groups:validate
Validate a region group upload
post-region_groups:validate 1 param body → 200400401403406413422429

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are Notification (13 properties), Region (7 properties), RegionGroup (6 properties), RFC9457ProblemDetail (6 properties). Each schema is shown below with its type and property counts.

RFC9457ProblemDetail
object
6 properties 2 required
GeoJsonPolygon
object
RFC 7946 GeoJSON Polygon in WGS 84. Positions are [longitude, latitude] (note the order — this is the GeoJSON interchange standard, not the {latitude, longitud…
2 properties 2 required
Notification
object
Something that the user should be informed about.
13 properties 11 required
RegionGroupCreate
object
2 properties 2 required
Region
object
A named geographic boundary (WGS 84) used to gate program tier eligibility, tariffs, carbon feeds and reward offers. Names are globally unique and immutable on…
7 properties
RegionGroupValidationResult
object
3 properties
RegionGroupEntry
object
3 properties 2 required
RegionGroup
object
6 properties
RegionCreate
object
4 properties 2 required
RegionValidationResult
object
5 properties
RegionDetail
Region including its full geometry. Served for single-region requests; the geometry is omitted from region lists.
GeoJsonMultiPolygon
object
RFC 7946 GeoJSON MultiPolygon in WGS 84. Positions are [longitude, latitude]. Each member is a Polygon coordinate array.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ev-energy-regions-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 Programs API
ev.energy Rebates API
Where this information came from

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