Add a new location

x-ms-visibility: "important"

Creates a location.

Path Parameters

integrationId string required

Integration ID

application/json

Request Body required

Details for the location

name string
publish boolean nullable
publishAllowedTo object[]
Array [
uid string
type string
Possible values: [AD_HOC_USER, APP_USER, OTHER, RFID]
Default value: AD_HOC_USER
visualNumber string
issuer string
groupId string
]
address string
city string
postalCode string
state string
country string
coordinates object
latitude string
longitude string
relatedLocations object[]
Array [
latitude string
longitude string
name object
language string
text string
]
parkingType string nullable

Possible values: [ALONG_MOTORWAY, PARKING_GARAGE, PARKING_LOT, ON_DRIVEWAY, ON_STREET, UNDERGROUND_GARAGE, OTHER, UNKNOWN]

Default value: ALONG_MOTORWAY

directions object[]
Array [
language string
text string
]
operator object
name string
website uri
logo object
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
suboperator object
name string
website uri
logo object
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
owner object
name string
website uri
logo object
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
facilities string[]

Possible values: [HOTEL, RESTAURANT, CAFE, MALL, SUPERMARKET, SPORT, RECREATION_AREA, NATURE, MUSEUM, BIKE_SHARING, BUS_STOP, TAXI_STAND, TRAM_STOP, METRO_STATION, TRAIN_STATION, AIRPORT, PARKING_LOT, CARPOOL_PARKING, FUEL_STATION, WIFI]

timezone string
openingTimes object
twentyfourseven boolean
regularHours object[]
Array [
weekday int32
periodBegin string
periodEnd string
]
exceptionalOpenings object[]
Array [
periodBegin date-time
periodEnd date-time
]
exceptionalClosings object[]
Array [
periodBegin date-time
periodEnd date-time
]
chargingWhenClosed boolean nullable
images object[]
Array [
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
]
locationEnergyMix object
isGreenEnergy boolean
energySources object[]
Array [
source string
Possible values: [NUCLEAR, GENERAL_FOSSIL, COAL, GAS, GENERAL_GREEN, SOLAR, WIND, WATER]
Default value: NUCLEAR
percentage float
]
environImpact object[]
Array [
category string
Possible values: [NUCLEAR_WASTE, CARBON_DIOXIDE]
Default value: NUCLEAR_WASTE
amount float
]
supplierName string
energyProductName string
chargers object[]
Array [
chargerId string
connector object[]
Array [
id string
tariffIds string[]
]
]
siteId int64 nullable
tariffIds string[]

Responses

• 201
• 400
• 401

---

Created location ID

application/json

Schema

Example (from schema)

---

Schema

id string
integrationId string
externalId string
countryCode string
name string
publish boolean nullable
publishAllowedTo object[]
Array [
uid string
type string
Possible values: [AD_HOC_USER, APP_USER, OTHER, RFID]
Default value: AD_HOC_USER
visualNumber string
issuer string
groupId string
]
address string
city string
postalCode string
state string
country string
coordinates object
latitude string
longitude string
relatedLocations object[]
Array [
latitude string
longitude string
name object
language string
text string
]
parkingType string nullable

Possible values: [ALONG_MOTORWAY, PARKING_GARAGE, PARKING_LOT, ON_DRIVEWAY, ON_STREET, UNDERGROUND_GARAGE, OTHER, UNKNOWN]

Default value: ALONG_MOTORWAY

directions object[]
Array [
language string
text string
]
owner object
name string
website uri
logo object
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
suboperator object
name string
website uri
logo object
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
facilities string[]

Possible values: [HOTEL, RESTAURANT, CAFE, MALL, SUPERMARKET, SPORT, RECREATION_AREA, NATURE, MUSEUM, BIKE_SHARING, BUS_STOP, TAXI_STAND, TRAM_STOP, METRO_STATION, TRAIN_STATION, AIRPORT, PARKING_LOT, CARPOOL_PARKING, FUEL_STATION, WIFI]

timezone string
openingTimes object
twentyfourseven boolean
regularHours object[]
Array [
weekday int32
periodBegin string
periodEnd string
]
exceptionalOpenings object[]
Array [
periodBegin date-time
periodEnd date-time
]
exceptionalClosings object[]
Array [
periodBegin date-time
periodEnd date-time
]
chargingWhenClosed boolean nullable
images object[]
Array [
url uri
thumbnail uri
category string
Possible values: [CHARGER, ENTRANCE, LOCATION, NETWORK, OPERATOR, OTHER, OWNER]
Default value: CHARGER
type string
width int32
height int32
]
locationEnergyMix object
isGreenEnergy boolean
energySources object[]
Array [
source string
Possible values: [NUCLEAR, GENERAL_FOSSIL, COAL, GAS, GENERAL_GREEN, SOLAR, WIND, WATER]
Default value: NUCLEAR
percentage float
]
environImpact object[]
Array [
category string
Possible values: [NUCLEAR_WASTE, CARBON_DIOXIDE]
Default value: NUCLEAR_WASTE
amount float
]
supplierName string
energyProductName string
siteId int64 nullable
evses object[]
Array [
chargerId string
connector object[]
Array [
id string
tariffIds string[]
]
]
lastUpdated date-time
chargers object[]
Array [
chargerId string
chargerName string
evseId string
splitEvseBySocket boolean
siteName string
siteId int64
amountOfSockets int64
activeConnection boolean
sockets object[]
Array [
id int32
name string
type string
status string
format string
socketPowerType string
maxVoltage int32 nullable
maxAmperage int32 nullable
maxWatts int32 nullable
tariffs object[]
Array [
id string
name string
currency string
]
]
]

{
  "id": "string",
  "integrationId": "string",
  "externalId": "string",
  "countryCode": "string",
  "name": "string",
  "publish": true,
  "publishAllowedTo": [
    {
      "uid": "string",
      "type": "AD_HOC_USER",
      "visualNumber": "string",
      "issuer": "string",
      "groupId": "string"
    }
  ],
  "address": "string",
  "city": "string",
  "postalCode": "string",
  "state": "string",
  "country": "string",
  "coordinates": {
    "latitude": "string",
    "longitude": "string"
  },
  "relatedLocations": [
    {
      "latitude": "string",
      "longitude": "string",
      "name": {
        "language": "string",
        "text": "string"
      }
    }
  ],
  "parkingType": "ALONG_MOTORWAY",
  "directions": [
    {
      "language": "string",
      "text": "string"
    }
  ],
  "owner": {
    "name": "string",
    "website": "string",
    "logo": {
      "url": "string",
      "thumbnail": "string",
      "category": "CHARGER",
      "type": "string",
      "width": 0,
      "height": 0
    }
  },
  "suboperator": {
    "name": "string",
    "website": "string",
    "logo": {
      "url": "string",
      "thumbnail": "string",
      "category": "CHARGER",
      "type": "string",
      "width": 0,
      "height": 0
    }
  },
  "facilities": [
    "HOTEL"
  ],
  "timezone": "string",
  "openingTimes": {
    "twentyfourseven": true,
    "regularHours": [
      {
        "weekday": 0,
        "periodBegin": "string",
        "periodEnd": "string"
      }
    ],
    "exceptionalOpenings": [
      {
        "periodBegin": "2025-06-25T07:58:51.677Z",
        "periodEnd": "2025-06-25T07:58:51.677Z"
      }
    ],
    "exceptionalClosings": [
      {
        "periodBegin": "2025-06-25T07:58:51.677Z",
        "periodEnd": "2025-06-25T07:58:51.677Z"
      }
    ]
  },
  "chargingWhenClosed": true,
  "images": [
    {
      "url": "string",
      "thumbnail": "string",
      "category": "CHARGER",
      "type": "string",
      "width": 0,
      "height": 0
    }
  ],
  "locationEnergyMix": {
    "isGreenEnergy": true,
    "energySources": [
      {
        "source": "NUCLEAR",
        "percentage": 0
      }
    ],
    "environImpact": [
      {
        "category": "NUCLEAR_WASTE",
        "amount": 0
      }
    ],
    "supplierName": "string",
    "energyProductName": "string"
  },
  "siteId": 0,
  "evses": [
    {
      "chargerId": "string",
      "connector": [
        {
          "id": "string",
          "tariffIds": [
            "string"
          ]
        }
      ]
    }
  ],
  "lastUpdated": "2025-06-25T07:58:51.677Z",
  "chargers": [
    {
      "chargerId": "string",
      "chargerName": "string",
      "evseId": "string",
      "splitEvseBySocket": true,
      "siteName": "string",
      "siteId": 0,
      "amountOfSockets": 0,
      "activeConnection": true,
      "sockets": [
        {
          "id": 0,
          "name": "string",
          "type": "string",
          "status": "string",
          "format": "string",
          "socketPowerType": "string",
          "maxVoltage": 0,
          "maxAmperage": 0,
          "maxWatts": 0,
          "tariffs": [
            {
              "id": "string",
              "name": "string",
              "currency": "string"
            }
          ]
        }
      ]
    }
  ]
}

Validation error occurred.

application/json

Schema

Example (from schema)

---

Schema

errorCode string
message string
errorNumber int32
helpLink string

{
  "errorCode": "string",
  "message": "string",
  "errorNumber": 0,
  "helpLink": "string"
}

User not authorized.

Loading...