Provides information of integration

x-ms-visibility: "important"

Use this endpoint to get integration details.

Path Parameters

integrationId string required

This is the globally unique ID for the integration

Responses

• 200
• 400
• 401

---

Return the JSON representation of integration details

application/json

Schema

Example (from schema)

---

Schema

integrationId string
integrationType string
integrationName string
integrationStatus string
statusDescription string
versionDetails object
version string
endpoints object[]
Array [
identifier string
Possible values: [cdrs, chargingprofiles, commands, credentials, hubclientinfo, locations, sessions, tariffs, tokens]
Default value: cdrs
role string nullable
Possible values: [SENDER, RECEIVER, BOTH]
Default value: SENDER
url uri
]
credentialsExchangeRole string
endPointURL uri

If UtilityCloud integration, then contains scope

partnersCompanyDetail object[]
Also party data of the actual third party if credentials exchange has been done with a platform party
Array [
role string
partyId string
countryCode string
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
]
platformIntegration boolean
platformIntegrationId string
platformPartyId string
platformPartyCountryCode string
locations object[]
Array [
id string
lastUpdated date-time
name string
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
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
]
chargingWhenClosed boolean nullable
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
]
timezone string
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]
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
directions object[]
Array [
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
relatedLocations object[]
Array [
latitude string
longitude string
name object
language string
text string
]
coordinates object
latitude string
longitude string
country string
state string
postalCode string
city string
address string
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
]
publish boolean nullable
chargers object[]
Array [
chargerID string
chargerName string
chargerGroupName string
chargerGroupID int64
amountOfSockets int32
activeConnection boolean
sockets object[]
Array [
id int32
type string
status string
format string
socketPowerType string
tariffIds string[]
]
]
siteId int64 nullable
]
tariffs object[]
Array [
id string
name string
externalId string
currency string
common boolean
useType string nullable
Possible values: [COST, PRICE, OTHER]
Default value: COST
type string nullable
Possible values: [AD_HOC_PAYMENT, PROFILE_CHEAP, PROFILE_FAST, PROFILE_GREEN, REGULAR]
Default value: AD_HOC_PAYMENT
tariffAltText object[]
Array [
language string
text string
]
tariffAltUrl uri
minPrice object
exclVat double nullable
inclVat double nullable
maxPrice object
exclVat double nullable
inclVat double nullable
elements object[]
Array [
priceComponents object[]
Array [
type string nullable
Possible values: [ENERGY, FLAT, PARKING_TIME, TIME, SOCKET_COUNT, CHARGER_COUNT, ENERGY_SPOT, ENERGY_SPOT_LOCKED, MONTHLY_FLAT]
Default value: ENERGY
price double
Price excluding VAT
vat double nullable
margin double nullable
stepSize int32 nullable
marginPercentage double nullable
priceCap double nullable
costPercentage double nullable
biddingZone string
]
restrictions object
startTime string
endTime string
startDate string
endDate string
minKwh double nullable
maxKwh double nullable
minCurrent double nullable
maxCurrent double nullable
minPower double nullable
maxPower double nullable
minDuration int32 nullable
maxDuration int32 nullable
dayOfWeek string[]
Possible values: [MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY]
reservation string nullable
Possible values: [RESERVATION, RESERVATION_EXPIRES]
Default value: RESERVATION
]
startDateTime date-time nullable
endDateTime date-time nullable
tariffEnergyMix 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
created date-time nullable
lastUpdated date-time
]
customerRoles string[]

Possible values: [OpenData, CPO, EMSP, HUB, NAP, NSP, OTHER, SCSP, UNDEFINED]

models object
pushCdr boolean nullable
pushSession boolean nullable
pushTariff boolean nullable
pushLocation boolean nullable
pullTokensAll boolean nullable
pullTariff boolean nullable
pullLocation boolean nullable
pullSession boolean nullable
pullCdr boolean nullable
pullVersionDetails boolean nullable
chargingPeriodIntervalInMinutes int32 nullable
stateofChargeIsSent boolean
freeVendingWithIdtagAllowed boolean
utilityCloudConnection object
tenant string
clientId string
clientSecret string
meteredValuesAreSent boolean nullable
activateConnection boolean nullable

{
  "integrationId": "string",
  "integrationType": "string",
  "integrationName": "string",
  "integrationStatus": "string",
  "statusDescription": "string",
  "versionDetails": {
    "version": "string",
    "endpoints": [
      {
        "identifier": "cdrs",
        "role": "SENDER",
        "url": "string"
      }
    ]
  },
  "credentialsExchangeRole": "string",
  "endPointURL": "string",
  "partnersCompanyDetail": [
    {
      "role": "string",
      "partyId": "string",
      "countryCode": "string",
      "name": "string",
      "website": "string",
      "logo": {
        "url": "string",
        "thumbnail": "string",
        "category": "CHARGER",
        "type": "string",
        "width": 0,
        "height": 0
      }
    }
  ],
  "platformIntegration": true,
  "platformIntegrationId": "string",
  "platformPartyId": "string",
  "platformPartyCountryCode": "string",
  "locations": [
    {
      "id": "string",
      "lastUpdated": "2025-03-31T07:22:20.875Z",
      "name": "string",
      "locationEnergyMix": {
        "isGreenEnergy": true,
        "energySources": [
          {
            "source": "NUCLEAR",
            "percentage": 0
          }
        ],
        "environImpact": [
          {
            "category": "NUCLEAR_WASTE",
            "amount": 0
          }
        ],
        "supplierName": "string",
        "energyProductName": "string"
      },
      "images": [
        {
          "url": "string",
          "thumbnail": "string",
          "category": "CHARGER",
          "type": "string",
          "width": 0,
          "height": 0
        }
      ],
      "chargingWhenClosed": true,
      "openingTimes": {
        "twentyfourseven": true,
        "regularHours": [
          {
            "weekday": 0,
            "periodBegin": "string",
            "periodEnd": "string"
          }
        ],
        "exceptionalOpenings": [
          {
            "periodBegin": "2025-03-31T07:22:20.875Z",
            "periodEnd": "2025-03-31T07:22:20.875Z"
          }
        ],
        "exceptionalClosings": [
          {
            "periodBegin": "2025-03-31T07:22:20.875Z",
            "periodEnd": "2025-03-31T07:22:20.875Z"
          }
        ]
      },
      "timezone": "string",
      "facilities": [
        "HOTEL"
      ],
      "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
        }
      },
      "directions": [
        {
          "language": "string",
          "text": "string"
        }
      ],
      "parkingType": "ALONG_MOTORWAY",
      "relatedLocations": [
        {
          "latitude": "string",
          "longitude": "string",
          "name": {
            "language": "string",
            "text": "string"
          }
        }
      ],
      "coordinates": {
        "latitude": "string",
        "longitude": "string"
      },
      "country": "string",
      "state": "string",
      "postalCode": "string",
      "city": "string",
      "address": "string",
      "publishAllowedTo": [
        {
          "uid": "string",
          "type": "AD_HOC_USER",
          "visualNumber": "string",
          "issuer": "string",
          "groupId": "string"
        }
      ],
      "publish": true,
      "chargers": [
        {
          "chargerID": "string",
          "chargerName": "string",
          "chargerGroupName": "string",
          "chargerGroupID": 0,
          "amountOfSockets": 0,
          "activeConnection": true,
          "sockets": [
            {
              "id": 0,
              "type": "string",
              "status": "string",
              "format": "string",
              "socketPowerType": "string",
              "tariffIds": [
                "string"
              ]
            }
          ]
        }
      ],
      "siteId": 0
    }
  ],
  "tariffs": [
    {
      "id": "string",
      "name": "string",
      "externalId": "string",
      "currency": "string",
      "common": true,
      "useType": "COST",
      "type": "AD_HOC_PAYMENT",
      "tariffAltText": [
        {
          "language": "string",
          "text": "string"
        }
      ],
      "tariffAltUrl": "string",
      "minPrice": {
        "exclVat": 0,
        "inclVat": 0
      },
      "maxPrice": {
        "exclVat": 0,
        "inclVat": 0
      },
      "elements": [
        {
          "priceComponents": [
            {
              "type": "ENERGY",
              "price": 0,
              "vat": 0,
              "margin": 0,
              "stepSize": 0,
              "marginPercentage": 0,
              "priceCap": 0,
              "costPercentage": 0,
              "biddingZone": "string"
            }
          ],
          "restrictions": {
            "startTime": "string",
            "endTime": "string",
            "startDate": "string",
            "endDate": "string",
            "minKwh": 0,
            "maxKwh": 0,
            "minCurrent": 0,
            "maxCurrent": 0,
            "minPower": 0,
            "maxPower": 0,
            "minDuration": 0,
            "maxDuration": 0,
            "dayOfWeek": [
              "MONDAY"
            ],
            "reservation": "RESERVATION"
          }
        }
      ],
      "startDateTime": "2025-03-31T07:22:20.876Z",
      "endDateTime": "2025-03-31T07:22:20.876Z",
      "tariffEnergyMix": {
        "isGreenEnergy": true,
        "energySources": [
          {
            "source": "NUCLEAR",
            "percentage": 0
          }
        ],
        "environImpact": [
          {
            "category": "NUCLEAR_WASTE",
            "amount": 0
          }
        ],
        "supplierName": "string",
        "energyProductName": "string"
      },
      "created": "2025-03-31T07:22:20.876Z",
      "lastUpdated": "2025-03-31T07:22:20.876Z"
    }
  ],
  "customerRoles": [
    "OpenData"
  ],
  "models": {
    "pushCdr": true,
    "pushSession": true,
    "pushTariff": true,
    "pushLocation": true,
    "pullTokensAll": true,
    "pullTariff": true,
    "pullLocation": true,
    "pullSession": true,
    "pullCdr": true,
    "pullVersionDetails": true
  },
  "chargingPeriodIntervalInMinutes": 0,
  "stateofChargeIsSent": true,
  "freeVendingWithIdtagAllowed": true,
  "utilityCloudConnection": {
    "tenant": "string",
    "clientId": "string",
    "clientSecret": "string",
    "meteredValuesAreSent": true,
    "activateConnection": true
  }
}

Something went wrong

Not authorised

Loading...