Ampcontrol API (2.0.0)

Download OpenAPI specification:Download

ampcontrol.io is an AI-based optimization service accessible through an API for charging point operators (CPO), car manufacturers, and developers. It delivers a toolset to generate optimized charging profiles for electric vehicle (EV) charging stations (Smart Charging).

Baseloads

/v2/base_loads/

Submit network base load values

Request Body schema: application/json
Array ()
networkId
required
string <uuid> (uuid)
time
required
string <date-time> (datetime)

ISO 8601

unit
required
string
Enum: "kW" "W"
value
required
number <float>

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}

/v2/base_loads/

Base load values

query Parameters
network
required
string <uuid> (uuid)
Example: network=33fe5b42-f717-43f6-ba0a-eab4cae81bfa

Filter by network

start_date
string <date-time> (datetime)
Example: start_date=2020-10-11T08:19:00+01:00

The start date must be used together with end_date.

end_date
string <date-time> (datetime)
Example: end_date=2020-10-11T08:19:00+01:00

The end date must be used together with start_date.

limit
integer [ 1 .. 1000 ]
Default: 100

The numbers of items to return.

offset
integer >= 0

The number of items to skip in the result list.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

/v2/base_loads/{id}

Base load values

path Parameters
id
required
string <uuid> (uuid)
Example: 33fe5b42-f717-43f6-ba0a-eab4cae81bfa

Resource ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Charge points

/v2/charge_points/

Add a charge point

Request Body schema: application/json
capacity
required
number <float>

Charge point capacity is always in kW

latitude
number <float>

Charge point location Latitude, + is North, - is South

longitude
number <float>

Charge point location Longitude, + is West, - is West

location
string
manufacturer
string
name
required
any <string>
networkId
required
string <uuid> (uuid)
currentType
string (current_type)
Enum: "DC" "AC_phase3_LN" "AC_phase3_LL" "AC_phase1"
protocol
string

Responses

Request samples

Content type
application/json
{
  • "capacity": 22,
  • "latitude": 32.2431,
  • "longitude": 115.793,
  • "location": "New York",
  • "manufacturer": "ABB",
  • "name": "EVSE 1",
  • "networkId": "33fe5b42-f717-43f6-ba0a-eab4cae81bfa",
  • "currentType": "DC",
  • "protocol": "OCPP 1.6"
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}

/v2/charge_points/

List charge points

query Parameters
network
string <uuid> (uuid)
Example: network=33fe5b42-f717-43f6-ba0a-eab4cae81bfa

Filter by network

limit
integer [ 1 .. 1000 ]
Default: 100

The numbers of items to return.

offset
integer >= 0

The number of items to skip in the result list.

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}

/v2/charge_points/{id}

Listcharge points.

path Parameters
id
required