Skip to content
CleverEV Logo CleverEV Logo CleverEV Documentation

List locations

GET
/api/locations/public

Lists locations that either contain public chargers, or are on a namespace accessible to the user.

Parameters

Header Parameters

x-compatibility-date
required
string
Allowed values: 2025-04-08

Request Body required

Responses

200

Response for status ok

object
success
required
boolean
totalCount
required
integer
<= 9007199254740991
items
required
Array<object>
object
id
required
string
>= 21 characters <= 21 characters
namespaceId
required
string
applicationId
required
string
durableObjectId
required
string
>= 64 characters <= 64 characters
name
required
string
<= 128 characters
timeZone
string
default: Etc/UTC
coordinates
object
latitude
required
number
>= -9007199254740991 <= 9007199254740991
longitude
required
number
>= -9007199254740991 <= 9007199254740991
tariff
required
object
elements
required
Array<object>
object
id
required
string
>= 21 characters <= 21 characters
name
required
string
<= 64 characters
backgroundColor
required
string
<= 12 characters
priceComponents
required
object
Flat
string
PerMinute
string
PerKilowattHour
string
restrictions
object
startTime
object
hour
required
integer
<= 23
minute
required
integer
<= 59
endTime
object
hour
required
integer
<= 23
minute
required
integer
<= 59
daysOfWeek
Array<string>
Allowed values: Mon Tue Wed Thu Fri Sat Sun
minEnergy
number
<= 9007199254740991
maxEnergy
number
<= 9007199254740991
minCurrent
number
<= 9007199254740991
maxCurrent
number
<= 9007199254740991
minPower
number
<= 9007199254740991
maxPower
number
<= 9007199254740991
minDuration
integer
<= 9007199254740991
maxDuration
integer
<= 9007199254740991
vehicleRequestingPower
boolean
minRestrictionsDuration
integer
>= -9007199254740991 <= 9007199254740991
minPrice
string
maxPrice
string
altTexts
Array<object>
object
language
required
string
>= 2 characters <= 2 characters
text
required
string
<= 512 characters
altUrl
string format: uri
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
deletedAt
string format: date-time
nullable
chargers
required
Array<object>
object
id
required
string
connectors
required
Array<object>
object
id
required
integer
> -9007199254740991 <= 9007199254740991
chargerId
required
string
type
string
Allowed values: J1772_Type1 Mennekes_Type2 GBT_AC Tesla CCS1 CCS2 CHAdeMO GBT_DC Other
maxPower
integer
> -9007199254740991 <= 9007199254740991
maxCurrent
integer
> -9007199254740991 <= 9007199254740991
status
string
Allowed values: Available Preparing Charging SuspendedEVSE SuspendedEV Finishing Reserved Unavailable Faulted
statusSince
string format: date-time
error
string
Allowed values: ConnectorLockFailure EVCommunicationError GroundFailure HighTemperature InternalError LocalListConflict NoError OtherError OverCurrentFailure OverVoltage PowerMeterFailure PowerSwitchFailure ReaderFailure ResetFailure UnderVoltage WeakSignal
expectTransaction
boolean
createdAt
required
string format: date-time
updatedAt
required
string format: date-time

500

Response for status internalServerError

object
success
required
boolean
message
required
string