Locations (v1)

Download OpenAPI specification:Download

A "Location" within the Locations API denotes a physical area, like a parking lot, where multiple Charging Stations are installed. It typically serves as a centralized hub for electric vehicle charging.

The Location object encapsulates key information, including its name, address, and geographical coordinates. To retrieve the IDs of Charging Stations at a specific Location, utilize the List Charging Stations of a Location endpoint.

In the API, locationUid (also known as id) is the internal identifier for the Location within the ChargEye system. The locationId field is allocated for customers to assign their internal location reference ID for flexibility.

Create a Location

post/locations

Use this endpoint to create a new Location within the system. The request should include necessary details such as the name, address, and geographical coordinates to describe the Location. Upon successful creation, the system returns the system-internal identifier (id).

SecuritybearerAuth
Request
Request Body schema: application/json
required
required
object (PostedCeLocation)
address
string or null
Array of items or null = 2 items

GeoJson line string bounding box. [[minLon, maxLat], [maxLon, minLat]]

city
string or null
country
string or null
countryCode
string or null

Country code in ISO 3166 alpha 2 format, two letter code

geo
Array of any

Any other GeoJson features, such as satellite placements. Features array.

Array of objects or null (CeCommonLabel)
lat
number or null

Central point. GEO location, latitude

lng
number or null

Central point. GEO location, longitude

locationId
string or null
name
string or null
object (BusinessDetails)

Represents the business details of an operator, suboperator or owner.

postalCode
string or null <= 10 characters

Postal code of the location

roamingPoolId
string or null
stationId
string

If stationId is posted, access to location will be inherited from station

Responses
200

OK

Response Schema: application/json
id
required
string
success
required
boolean
401

Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission

Request samples
application/json
{
  • "location": {
    },
  • "stationId": "string"
}
Response samples
application/json
{
  • "id": "string",
  • "success": true
}

List Locations

get/locations

Retrieve a list of all available Locations within the system. Each item in the response provides details about a specific Location, including its unique identifier, name, address, and geographical coordinates.

SecuritybearerAuth
Responses
200

OK

Response Schema: application/json
required
Array of objects (CensoredRowWithTenancy<LocationRow>)
Array
address
string or null
Array of items or null = 2 items

GeoJson line string bounding box. [[minLon, maxLat], [maxLon, minLat]]

city
string or null
country
string or null
countryCode
string or null

Country code in ISO 3166 alpha 2 format, two letter code

geo
Array of any

Any other GeoJson features, such as satellite placements. Features array.

id
required
string

location uid

Array of objects or null (CeCommonLabel)
lat
number or null

Central point. GEO location, latitude

lng
number or null

Central point. GEO location, longitude

locationId
string or null
name
string or null
object (BusinessDetails)

Represents the business details of an operator, suboperator or owner.

postalCode
string or null <= 10 characters

Postal code of the location

roamingPoolId
string or null
tenantIdCPO
required
string
Deprecated

use tenantIds instead

tenantIdEMSP
required
string
Deprecated

use tenantIds instead

tenantIdMaintenance
required
string
Deprecated

use tenantIds instead

tenantIds
required
Array of strings

Which tenants has access to this row

401

Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission

Request samples 
Response samples 
application/json
{
  • "locations": [
    ]
}
Update a Location
patch/locations/{locationUid}
Update the details of an existing Location by specifying its unique system-internal identifier.
Provide the modified attributes in the request body to update the Location's name, address, or geographical coordinates.


SecuritybearerAuth 
Request 
path Parameters
locationUid
required
string
 
Request Body schema: application/json
required
required
object (PartialCeLocation) 
 
address
string or null
 
Array of items or null  = 2 items 
GeoJson line string bounding box.
[[minLon, maxLat], [maxLon, minLat]]


 
city
string or null
 
country
string or null
 
countryCode
string or null
Country code in ISO 3166 alpha 2 format, two letter code


 
geo
Array of any
Any other GeoJson features, such as satellite placements.
Features array.


 
id
string
location uid


 
Array of objects or null (CeCommonLabel) 
 
lat
number or null
Central point. GEO location, latitude


 
lng
number or null
Central point. GEO location, longitude


 
locationId
string or null
 
name
string or null
 
object (BusinessDetails) 
Represents the business details of an operator, suboperator or owner.


 
postalCode
string or null  <= 10 characters 
Postal code of the location


 
roamingPoolId
string or null
 
Responses 
200
OK


Response Schema: application/json
success
required
boolean
 
401
Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission


Request samples 
application/json
{
  • "location": {
    }
}
Response samples 
application/json
{
  • "success": true
}
Get a Location
get/locations/{locationUid}
Access a specific location using its unique ID.
The response provides details about a specific Location,
including its name, address, and geographical coordinates.


Obtain the locationUid from the List Locations endpoint to use this operation.


SecuritybearerAuth 
Request 
path Parameters
locationUid
required
string
 
Responses 
200
OK


Response Schema: application/json
required
object (CensoredRowWithTenancy<LocationRow>) 
 
address
string or null
 
Array of items or null  = 2 items 
GeoJson line string bounding box.
[[minLon, maxLat], [maxLon, minLat]]


 
city
string or null
 
country
string or null
 
countryCode
string or null
Country code in ISO 3166 alpha 2 format, two letter code


 
geo
Array of any
Any other GeoJson features, such as satellite placements.
Features array.


 
id
required
string
location uid


 
Array of objects or null (CeCommonLabel) 
 
lat
number or null
Central point. GEO location, latitude


 
lng
number or null
Central point. GEO location, longitude


 
locationId
string or null
 
name
string or null
 
object (BusinessDetails) 
Represents the business details of an operator, suboperator or owner.


 
postalCode
string or null  <= 10 characters 
Postal code of the location


 
roamingPoolId
string or null
 
tenantIdCPO
required
string
 Deprecated 
use tenantIds instead


 
tenantIdEMSP
required
string
 Deprecated 
use tenantIds instead


 
tenantIdMaintenance
required
string
 Deprecated 
use tenantIds instead


 
tenantIds
required
Array of strings
Which tenants has access to this row


 
401
Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission


Request samples 
Response samples 
application/json
{
  • "location": {
    }
}
List Charging Stations of a Location
get/locations/{locationUid}/stations
Retrieve a list of Charging Stations associated with a specific Location, identified by its id.
The response includes the Charging Station IDs and other details of each Charging Station.


Retrieve the full details of a charging station with the Charging Stations API.


SecuritybearerAuth 
Request 
path Parameters
locationUid
required
string
 
Responses 
200
OK


Response Schema: application/json
required
Array of objects (CensoredRowWithTenancy<ChargingStationRow>) 
 
 Array 
object (StationClassification) 
Charging station or location classification metadata.


 
commissioningRequired
boolean or null
 
object
 
customerSuppliedId
string
ID a customer has given to this station


 
firmwareVersion
string or null
 
groupPath
string or null
 
Array of objects or null (CeCommonLabel) 
 
licenseId
string or null
licenseId to enforce permissions on this charger


 
licenseTenantId
string or null
tenantId which provides / pays for the license


 
object or null
 
locationUid
string or null
 
object (StationManufacturingInfo) 
 
maxPowerKw
number
Charger maximum output power at any point in time in kilowatts. How much power it can output simultaneously to all its connectors.


 
model
string or null
 
name
required
string
 
notes
string or null
 
operationalStatus
string (StationOperationalStatus) 
 Enum: "IN_OPERATION" "NOT_IN_OPERATION" "OUT_OF_ORDER"  
operator
string or null
 
stationCapabilities
string or null
Capabilities that the station supports as a comma separated list.
For example when station supports serial connectable power modules,
contents would be:
stationCapabilities = "SerialConnection,Xxx, ... ,Yyy"


 
stationId
required
string
Station unique identifier.


 
tenantIdCPO
required
string
 Deprecated 
use tenantIds instead


 
tenantIdEMSP
required
string
 Deprecated 
use tenantIds instead


 
tenantIdMaintenance
required
string
 Deprecated 
use tenantIds instead


 
tenantIds
required
Array of strings
Which tenants has access to this row


 
vendorName
string or null
 
401
Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission


Request samples 
Response samples 
application/json
{
  • "stations": [
    ]
}