Skip to content
/
Add a regional connector...

Add a regional connector to a vehicle model

Request

Create a connector row for one region of a vehicle model. (vehicle_model, region) is unique; adding a second row for the same region returns a 400. Requires the vehicle_catalogue:write scope.

Security
oauth2(Required scopes: vehicle_catalogue:write)
Path
vehicle_model_idstringvmod[A-Z\d]{26}required

The ID of the specific vehicle model to retrieve.

Example:vmod01HSBR8Z36GD7A46K7M4R12VG0
Headers
EvEnergy-Versionnumber

Specify the version of this endpoint to use.

Value:2
Bodyapplication/jsonrequired
regionstringrequired
Enum:"NORTH_AMERICA""EUROPE"
connector_typestringrequired
Enum:"CCS""NACS""CHADEMO""GBT"
sourcestring or null
Enum:"EV_ENERGY""CAR_API""USER""DVLA""PROVIDER""FLEET"null
confidencestring or null
Enum:"HIGH""MEDIUM""LOW"null
verified_atstring or null, (date-time)
curl -i -X POST \
  https://developers.ev.energy/_mock/ev.energy-api-v2/vehicle_models/vmod01HSBR8Z36GD7A46K7M4R12VG0/connectors \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'EvEnergy-Version: 2' \
  -d '{
    "region": "NORTH_AMERICA",
    "connector_type": "CCS",
    "source": "EV_ENERGY",
    "confidence": "HIGH",
    "verified_at": "2019-08-24T14:15:22Z"
  }'

Responses

The regional connector was created.

Headers
EvEnergy-Versionnumber

Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.

Value:2
X-RateLimit-Limitnumber

The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

Default:1000
X-RateLimit-Remainingnumber

The number of requests remaining until this client's rate limit is reached.

Default:999
Bodyapplication/json
urlstring, (uri)read-onlyrequired
Example:"https://api.ev.energy/v2/vehicle_models/vmod01HRFF3SEVSCRAV9B3CHVDFN0H/connectors/NORTH_AMERICA"
vehicle_modelstring, (uri)read-onlyrequired

Link to the vehicle model this connector belongs to.

Example:"https://api.ev.energy/v2/vehicle_models/vmod01HRFF3SEVSCRAV9B3CHVDFN0H"
regionstringrequired

The charging region this connector applies in.

Enum:"NORTH_AMERICA""EUROPE"
connector_typestringrequired

The model's native DC-fast connector in this region.

Enum:"CCS""NACS""CHADEMO""GBT"
sourcestring or nullrequired

Provenance of this regional connector value.

Enum:"EV_ENERGY""CAR_API""USER""DVLA""PROVIDER""FLEET"null
confidencestring or nullrequired

Curator confidence in this value.

Enum:"HIGH""MEDIUM""LOW"null
verified_atstring or null, (date-time)required

When this value was last verified.

updated_atstring, (date-time)read-onlyrequired
Response
{
  "url": "https://api.ev.energy/v2/vehicle_models/vmod01HRFF3SEVSCRAV9B3CHVDFN0H/connectors/NORTH_AMERICA",
  "vehicle_model": "https://api.ev.energy/v2/vehicle_models/vmod01HRFF3SEVSCRAV9B3CHVDFN0H",
  "region": "NORTH_AMERICA",
  "connector_type": "CCS",
  "source": "EV_ENERGY",
  "confidence": "HIGH",
  "verified_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}