GraphQL API Reference
Welcome to the technical specification for the GraphQL API.
You will find here all available endpoints (queries and mutations) which can be used.
For all endpoints you will find an explanation about the purpose, types, and how they should be used.
Some of the endpoints are marked as deprecated. Please don't use them any more for new developments, because soon enough they will be removed. We will inform you about that beforehand.
If you face any problems, please do not hesitate to contact us via support-beenergised@chargepoint.com.
API Endpoints
https://<your-subdomain>.v2.api.htb.services/graphql/
Queries
accountDocument
Description
Get a document by it's ID.
Response
Returns an AccountDocument
Arguments
Name | Description |
---|---|
id - String
|
Example
Query
query accountDocument($id: String) {
accountDocument(id: $id) {
documentDate
downloadLink
id
title
type
}
}
Variables
{"id": "abc123"}
Response
{
"data": {
"accountDocument": {
"documentDate": "2007-12-03T10:15:30Z",
"downloadLink": "xyz789",
"id": "xyz789",
"title": "xyz789",
"type": "creditnote"
}
}
}
accountDocumentsPaged
Description
Get the list of all documents of the authenticated user.
Response
Returns an AccountDocumentsPaged
Arguments
Name | Description |
---|---|
pagination - PaginationFilter
|
Example
Query
query accountDocumentsPaged($pagination: PaginationFilter) {
accountDocumentsPaged(pagination: $pagination) {
data {
...AccountDocumentFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{"pagination": PaginationFilter}
Response
{
"data": {
"accountDocumentsPaged": {
"data": [AccountDocument],
"pagination": Pagination
}
}
}
additionalRegistrationFields
Response
Returns [AdditionalRegistrationField]
Example
Query
query additionalRegistrationFields {
additionalRegistrationFields {
description
name
required
type
value
}
}
Response
{
"data": {
"additionalRegistrationFields": [
{
"description": "abc123",
"name": "xyz789",
"required": "abc123",
"type": "xyz789",
"value": "xyz789"
}
]
}
}
availableCardsForChargingProcess
Description
Get a list of authentication media (cards) of the authorized user which can be used to start a charging process on a specific connector.
Response
Returns [CardForChargingProcess]
Arguments
Name | Description |
---|---|
connectorId - String!
|
Example
Query
query availableCardsForChargingProcess($connectorId: String!) {
availableCardsForChargingProcess(connectorId: $connectorId) {
expiryDate
id
label
number
rate {
...RateDescriptionForChargingProcessFragment
}
tagId
type
}
}
Variables
{"connectorId": "xyz789"}
Response
{
"data": {
"availableCardsForChargingProcess": [
{
"expiryDate": "2007-12-03T10:15:30Z",
"id": "xyz789",
"label": "xyz789",
"number": "abc123",
"rate": RateDescriptionForChargingProcess,
"tagId": "xyz789",
"type": "default"
}
]
}
}
bankAccount
Response
Returns a BankAccountResponse
Example
Query
query bankAccount {
bankAccount {
accountHolder
bank
bic
iban
}
}
Response
{
"data": {
"bankAccount": {
"accountHolder": "abc123",
"bank": "xyz789",
"bic": "abc123",
"iban": "xyz789"
}
}
}
card
Description
Get a card by tag id or uuid.
Example
Query
query card($id: String!) {
card(id: $id) {
expiryDate
id
label
number
rate {
...RateOptionFragment
}
status
tagId
type
}
}
Variables
{"id": "abc123"}
Response
{
"data": {
"card": {
"expiryDate": "2007-12-03T10:15:30Z",
"id": "xyz789",
"label": "abc123",
"number": "abc123",
"rate": RateOption,
"status": "active",
"tagId": "abc123",
"type": "default"
}
}
}
cardsPaged
Description
Get a list of authentication media (cards) of the authorized user.
Response
Returns a CardsPaged
Arguments
Name | Description |
---|---|
pagination - PaginationFilter
|
Example
Query
query cardsPaged($pagination: PaginationFilter) {
cardsPaged(pagination: $pagination) {
data {
...CardFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{"pagination": PaginationFilter}
Response
{
"data": {
"cardsPaged": {
"data": [Card],
"pagination": Pagination
}
}
}
chargelog
Description
Get a chargelog by id.
Example
Query
query chargelog($id: ID!) {
chargelog(id: $id) {
authId
authType
calibrationDetails
co2Saving
connector {
...ConnectorFragment
}
cost {
...CostFragment
}
dateEnd
dateStart
energyConsumption
id
meterEnd
meterStart
rateName
sessionId
status
}
}
Variables
{"id": "4"}
Response
{
"data": {
"chargelog": {
"authId": "xyz789",
"authType": "xyz789",
"calibrationDetails": "xyz789",
"co2Saving": 987.65,
"connector": Connector,
"cost": Cost,
"dateEnd": "2007-12-03T10:15:30Z",
"dateStart": "2007-12-03T10:15:30Z",
"energyConsumption": 123.45,
"id": 4,
"meterEnd": 123,
"meterStart": 123,
"rateName": "xyz789",
"sessionId": "xyz789",
"status": "abc123"
}
}
}
chargelogMeterValuesSummary
Description
Returns detailed information about the meter values of a charging session.
In some cases, we do not receive meter values during the charging session. In this case, only null values will be returned.
As parameter you will need the uuid of the charging station. This can be obtained by chargelogsPaged, among others.
Response
Returns a chargelogMeterValuesSummary
Arguments
Name | Description |
---|---|
uuid - String!
|
The uuid of the charging session |
Example
Query
query chargelogMeterValuesSummary($uuid: String!) {
chargelogMeterValuesSummary(uuid: $uuid) {
currentPower
currentPowerLastChanged
currentStateOfCharge
energyFirstValue
energyFirstValueTime
energyLastValue
energyLastValueTime
energyUpdatedAt
initialStateOfCharge
stateOfChargeLastChanged
sumEnergy
updatedAt
}
}
Variables
{"uuid": "abc123"}
Response
{
"data": {
"chargelogMeterValuesSummary": {
"currentPower": 123,
"currentPowerLastChanged": "xyz789",
"currentStateOfCharge": 123,
"energyFirstValue": 987.65,
"energyFirstValueTime": "abc123",
"energyLastValue": 123.45,
"energyLastValueTime": "xyz789",
"energyUpdatedAt": "abc123",
"initialStateOfCharge": 123,
"stateOfChargeLastChanged": "abc123",
"sumEnergy": 123.45,
"updatedAt": "xyz789"
}
}
}
chargelogsPaged
Description
Get a list of chargelogs of the authorized user, filterable with a ChargelogFilter object.
Response
Returns a ChargelogsPaged
Arguments
Name | Description |
---|---|
filters - ChargelogFilter
|
|
pagination - PaginationFilter
|
|
timeframe - TimeFrameFilter
|
|
type - ChargeLogType
|
Example
Query
query chargelogsPaged(
$filters: ChargelogFilter,
$pagination: PaginationFilter,
$timeframe: TimeFrameFilter,
$type: ChargeLogType
) {
chargelogsPaged(
filters: $filters,
pagination: $pagination,
timeframe: $timeframe,
type: $type
) {
data {
...ChargelogFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filters": ChargelogFilter,
"pagination": PaginationFilter,
"timeframe": TimeFrameFilter,
"type": "contact"
}
Response
{
"data": {
"chargelogsPaged": {
"data": [Chargelog],
"pagination": Pagination
}
}
}
chargingStatistics
Description
Get statistics for chargelogs (optionally within a specific timerange)
Response
Returns a ChargingStatistics
Arguments
Name | Description |
---|---|
timeframe - TimeFrameFilter
|
Example
Query
query chargingStatistics($timeframe: TimeFrameFilter) {
chargingStatistics(timeframe: $timeframe) {
co2Saving
energyConsumption
number
}
}
Variables
{"timeframe": TimeFrameFilter}
Response
{
"data": {
"chargingStatistics": {
"co2Saving": 987.65,
"energyConsumption": 987.65,
"number": 987
}
}
}
connector
Description
Load a single connector
Response
Returns a Connector
Example
Query
query connector(
$id: ID!,
$ignoreMarketingConfiguration: Boolean
) {
connector(
id: $id,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration
) {
connectorType {
...ConnectorTypeFragment
}
cp {
...CpFragment
}
evseId
freeOfCharge
id
label
sortOrder
status {
...ConnectorStatusFragment
}
}
}
Variables
{
"id": "4",
"ignoreMarketingConfiguration": false
}
Response
{
"data": {
"connector": {
"connectorType": ConnectorType,
"cp": Cp,
"evseId": "abc123",
"freeOfCharge": false,
"id": "4",
"label": "xyz789",
"sortOrder": "xyz789",
"status": ConnectorStatus
}
}
}
connectorByEvseId
Description
Load a single connector by its EVSEID.
Response
Returns a Connector
Example
Query
query connectorByEvseId(
$evseId: String!,
$ignoreMarketingConfiguration: Boolean
) {
connectorByEvseId(
evseId: $evseId,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration
) {
connectorType {
...ConnectorTypeFragment
}
cp {
...CpFragment
}
evseId
freeOfCharge
id
label
sortOrder
status {
...ConnectorStatusFragment
}
}
}
Variables
{
"evseId": "abc123",
"ignoreMarketingConfiguration": false
}
Response
{
"data": {
"connectorByEvseId": {
"connectorType": ConnectorType,
"cp": Cp,
"evseId": "xyz789",
"freeOfCharge": false,
"id": 4,
"label": "abc123",
"sortOrder": "abc123",
"status": ConnectorStatus
}
}
}
connectorsPaged
Description
Load a list of connectors with pagination
Response
Returns a ConnectorPaged
Arguments
Name | Description |
---|---|
ignoreMarketingConfiguration - Boolean
|
|
pagination - PaginationFilter
|
Example
Query
query connectorsPaged(
$ignoreMarketingConfiguration: Boolean,
$pagination: PaginationFilter
) {
connectorsPaged(
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
pagination: $pagination
) {
data {
...ConnectorFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"ignoreMarketingConfiguration": true,
"pagination": PaginationFilter
}
Response
{
"data": {
"connectorsPaged": {
"data": [Connector],
"pagination": Pagination
}
}
}
contact
Response
Returns a Contact
Example
Query
query contact {
contact {
address {
...AddressFragment
}
birthday
companyId
createdAt
displayName
email
firstName
gender
id
isCompany
language
mobile
name
phone
termsAndConditionsAccepted
updatedAt
vat
}
}
Response
{
"data": {
"contact": {
"address": Address,
"birthday": "2007-12-03T10:15:30Z",
"companyId": 987,
"createdAt": "2007-12-03T10:15:30Z",
"displayName": "xyz789",
"email": "abc123",
"firstName": "xyz789",
"gender": "company",
"id": "xyz789",
"isCompany": false,
"language": "cs_CZ",
"mobile": "abc123",
"name": "xyz789",
"phone": "abc123",
"termsAndConditionsAccepted": true,
"updatedAt": "2007-12-03T10:15:30Z",
"vat": "xyz789"
}
}
}
contractPaymentMethods
Response
Returns [ContractPaymentMethod]
Example
Query
query contractPaymentMethods {
contractPaymentMethods {
applicationId
cardCreateMode
createdAt
directPaymentMethod
emp
paymentName
paymentType
termsOfServiceUrl
termsOfUseUrl
updatedAt
uuid
}
}
Response
{
"data": {
"contractPaymentMethods": [
{
"applicationId": "xyz789",
"cardCreateMode": "abc123",
"createdAt": "2007-12-03T10:15:30Z",
"directPaymentMethod": "abc123",
"emp": "xyz789",
"paymentName": "abc123",
"paymentType": "abc123",
"termsOfServiceUrl": "xyz789",
"termsOfUseUrl": "xyz789",
"updatedAt": "2007-12-03T10:15:30Z",
"uuid": "abc123"
}
]
}
}
contractRateOptions
Description
Get rate options applicable to contracts and available to clients.
Response
Returns [RateOption]
Example
Query
query contractRateOptions {
contractRateOptions {
description
id
name
shortDescription
uuid
}
}
Response
{
"data": {
"contractRateOptions": [
{
"description": "xyz789",
"id": "abc123",
"name": "abc123",
"shortDescription": "abc123",
"uuid": "abc123"
}
]
}
}
cp
Description
Load a single cp
Example
Query
query cp(
$id: ID!,
$ignoreMarketingConfiguration: Boolean
) {
cp(
id: $id,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration
) {
accessType
additionalFields {
...AdditionalCpFieldFragment
}
address
city
connectors {
...ConnectorFragment
}
contact {
...ContactInformationFragment
}
country
id
images {
...CpImageFragment
}
information {
...CpInfoFragment
}
isFavoured
label
latitude
longitude
publicName
site {
...SiteFragment
}
siteId
status {
...CpStatusFragment
}
zip
}
}
Variables
{"id": 4, "ignoreMarketingConfiguration": true}
Response
{
"data": {
"cp": {
"accessType": "INTERNAL",
"additionalFields": [AdditionalCpField],
"address": "abc123",
"city": "abc123",
"connectors": [Connector],
"contact": ContactInformation,
"country": "xyz789",
"id": "4",
"images": [CpImage],
"information": CpInfo,
"isFavoured": true,
"label": "abc123",
"latitude": 123.45,
"longitude": 123.45,
"publicName": "xyz789",
"site": Site,
"siteId": "abc123",
"status": CpStatus,
"zip": "xyz789"
}
}
}
cpCapabilities
Description
Get the capabilities of an given charging station.
Response
Returns a CpCapabilities!
Arguments
Name | Description |
---|---|
id - String!
|
The uuid of the charging station. |
Example
Query
query cpCapabilities($id: String!) {
cpCapabilities(id: $id) {
hasRemoteCommands
}
}
Variables
{"id": "abc123"}
Response
{"data": {"cpCapabilities": {"hasRemoteCommands": true}}}
cpOccupancyRate
Response
Returns [OccupancyRate]
Arguments
Name | Description |
---|---|
cpId - String!
|
|
day - OccupancyDays!
|
Example
Query
query cpOccupancyRate(
$cpId: String!,
$day: OccupancyDays!
) {
cpOccupancyRate(
cpId: $cpId,
day: $day
) {
day
hour
occupancyRate
}
}
Variables
{"cpId": "xyz789", "day": "ALL"}
Response
{
"data": {
"cpOccupancyRate": [
{
"day": "xyz789",
"hour": 123,
"occupancyRate": 123.45
}
]
}
}
cpsPaged
Description
Load a list of stations with pagination based on filters (optional)
Response
Returns a CpsPaged
Arguments
Name | Description |
---|---|
filter - [ConnectorFilter]
|
|
freeOfCharge - Boolean
|
|
ignoreMarketingConfiguration - Boolean
|
|
pagination - PaginationFilter
|
|
tagId - String
|
Example
Query
query cpsPaged(
$filter: [ConnectorFilter],
$freeOfCharge: Boolean,
$ignoreMarketingConfiguration: Boolean,
$pagination: PaginationFilter,
$tagId: String
) {
cpsPaged(
filter: $filter,
freeOfCharge: $freeOfCharge,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
pagination: $pagination,
tagId: $tagId
) {
data {
...CpFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filter": [ConnectorFilter],
"freeOfCharge": false,
"ignoreMarketingConfiguration": false,
"pagination": PaginationFilter,
"tagId": "abc123"
}
Response
{
"data": {
"cpsPaged": {
"data": [Cp],
"pagination": Pagination
}
}
}
cpsPagedLocationBased
Description
Load a list of stations with pagination based on location
Response
Returns a CpsPaged
Arguments
Name | Description |
---|---|
filter - [ConnectorFilter]
|
|
freeOfCharge - Boolean
|
|
ignoreMarketingConfiguration - Boolean
|
|
location - LocationFilter
|
|
orderedByDistance - String
|
If the Cps should be returned ordered by the distance or not. The backend will order by distance when:
|
pagination - PaginationFilter
|
|
tagId - String
|
Example
Query
query cpsPagedLocationBased(
$filter: [ConnectorFilter],
$freeOfCharge: Boolean,
$ignoreMarketingConfiguration: Boolean,
$location: LocationFilter,
$orderedByDistance: String,
$pagination: PaginationFilter,
$tagId: String
) {
cpsPagedLocationBased(
filter: $filter,
freeOfCharge: $freeOfCharge,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
location: $location,
orderedByDistance: $orderedByDistance,
pagination: $pagination,
tagId: $tagId
) {
data {
...CpFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filter": [ConnectorFilter],
"freeOfCharge": false,
"ignoreMarketingConfiguration": false,
"location": LocationFilter,
"orderedByDistance": "abc123",
"pagination": PaginationFilter,
"tagId": "xyz789"
}
Response
{
"data": {
"cpsPagedLocationBased": {
"data": [Cp],
"pagination": Pagination
}
}
}
directPaymentChargingStatus
Response
Returns a DirectPaymentChargingStatus
Example
Query
query directPaymentChargingStatus(
$evseId: String!,
$transactionId: String!
) {
directPaymentChargingStatus(
evseId: $evseId,
transactionId: $transactionId
) {
chargeLogId
message
status
}
}
Variables
{
"evseId": "xyz789",
"transactionId": "xyz789"
}
Response
{
"data": {
"directPaymentChargingStatus": {
"chargeLogId": "xyz789",
"message": "xyz789",
"status": "abc123"
}
}
}
filters
Response
Returns [Filter]
Example
Query
query filters {
filters {
label
options {
...FilterOptionFragment
}
slug
type
}
}
Response
{
"data": {
"filters": [
{
"label": "xyz789",
"options": [FilterOption],
"slug": "FILTER_BY_CONNECTOR_TYPE",
"type": "abc123"
}
]
}
}
getFavouriteCps
Response
Returns [Cp]
Example
Query
query getFavouriteCps {
getFavouriteCps {
accessType
additionalFields {
...AdditionalCpFieldFragment
}
address
city
connectors {
...ConnectorFragment
}
contact {
...ContactInformationFragment
}
country
id
images {
...CpImageFragment
}
information {
...CpInfoFragment
}
isFavoured
label
latitude
longitude
publicName
site {
...SiteFragment
}
siteId
status {
...CpStatusFragment
}
zip
}
}
Response
{
"data": {
"getFavouriteCps": [
{
"accessType": "INTERNAL",
"additionalFields": [AdditionalCpField],
"address": "xyz789",
"city": "xyz789",
"connectors": [Connector],
"contact": ContactInformation,
"country": "xyz789",
"id": 4,
"images": [CpImage],
"information": CpInfo,
"isFavoured": true,
"label": "xyz789",
"latitude": 987.65,
"longitude": 123.45,
"publicName": "xyz789",
"site": Site,
"siteId": "xyz789",
"status": CpStatus,
"zip": "xyz789"
}
]
}
}
hasPaymentMedium
Description
Returns true if current user already has an active payment medium and false if not.
Response
Returns a Boolean
Example
Query
query hasPaymentMedium {
hasPaymentMedium
}
Response
{"data": {"hasPaymentMedium": false}}
locationsLocationBased
Response
Returns a LocationsPaged
Arguments
Name | Description |
---|---|
filter - [ConnectorFilter]
|
|
ignoreMarketingConfiguration - Boolean
|
|
location - LocationFilter
|
|
pagination - PaginationFilter
|
Example
Query
query locationsLocationBased(
$filter: [ConnectorFilter],
$ignoreMarketingConfiguration: Boolean,
$location: LocationFilter,
$pagination: PaginationFilter
) {
locationsLocationBased(
filter: $filter,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
location: $location,
pagination: $pagination
) {
locations {
...LocationFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filter": [ConnectorFilter],
"ignoreMarketingConfiguration": true,
"location": LocationFilter,
"pagination": PaginationFilter
}
Response
{
"data": {
"locationsLocationBased": {
"locations": [Location],
"pagination": Pagination
}
}
}
locationsPaged
Response
Returns a LocationsPaged
Arguments
Name | Description |
---|---|
filter - [ConnectorFilter]
|
|
ignoreMarketingConfiguration - Boolean
|
|
pagination - PaginationFilter
|
Example
Query
query locationsPaged(
$filter: [ConnectorFilter],
$ignoreMarketingConfiguration: Boolean,
$pagination: PaginationFilter
) {
locationsPaged(
filter: $filter,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
pagination: $pagination
) {
locations {
...LocationFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filter": [ConnectorFilter],
"ignoreMarketingConfiguration": false,
"pagination": PaginationFilter
}
Response
{
"data": {
"locationsPaged": {
"locations": [Location],
"pagination": Pagination
}
}
}
occupancyRate
Description
A query to get all occupancy of a connector
Response
Returns [OccupancyRate]
Arguments
Name | Description |
---|---|
connectors - [String]!
|
|
day - OccupancyDays!
|
Example
Query
query occupancyRate(
$connectors: [String]!,
$day: OccupancyDays!
) {
occupancyRate(
connectors: $connectors,
day: $day
) {
day
hour
occupancyRate
}
}
Variables
{"connectors": ["xyz789"], "day": "ALL"}
Response
{
"data": {
"occupancyRate": [
{
"day": "abc123",
"hour": 123,
"occupancyRate": 123.45
}
]
}
}
paymentMethods
Description
Get all payment cards registered in PSPs for the session user.
Response
Returns a PaymentMethods
Example
Query
query paymentMethods {
paymentMethods {
hostedSession {
...HostedPaymentMethodGetSessionFragment
}
nativeSession {
...NativePaymentMethodGetSessionFragment
}
}
}
Response
{
"data": {
"paymentMethods": {
"hostedSession": HostedPaymentMethodGetSession,
"nativeSession": NativePaymentMethodGetSession
}
}
}
ratePackageByConnectorId
Description
Get all rate packages by a specific connector uuid.
Response
Returns [RatePackage]
Arguments
Name | Description |
---|---|
id - String
|
Example
Query
query ratePackageByConnectorId($id: String) {
ratePackageByConnectorId(id: $id) {
amount
automaticStop
id
rate {
...RateOptionFragment
}
visibleRuntime
}
}
Variables
{"id": "abc123"}
Response
{
"data": {
"ratePackageByConnectorId": [
{
"amount": 987.65,
"automaticStop": 123,
"id": "abc123",
"rate": RateOption,
"visibleRuntime": 123
}
]
}
}
remoteStartAttemptStatus
Description
Get the current status of the remoteStartAttempt
Response
Returns an AttemptRemoteStartResponse!
Arguments
Name | Description |
---|---|
id - String!
|
The id which you will get back after triggering a remoteStartAttempt |
Example
Query
query remoteStartAttemptStatus($id: String!) {
remoteStartAttemptStatus(id: $id) {
chargeLogId
connectorId
failureReason
id
isFailure
lastSentAt
status
}
}
Variables
{"id": "xyz789"}
Response
{
"data": {
"remoteStartAttemptStatus": {
"chargeLogId": "abc123",
"connectorId": "abc123",
"failureReason": "abc123",
"id": 4,
"isFailure": true,
"lastSentAt": "xyz789",
"status": "abc123"
}
}
}
settings
Response
Returns [Setting!]!
Arguments
Name | Description |
---|---|
key - String
|
Example
Query
query settings($key: String) {
settings(key: $key) {
key
value
}
}
Variables
{"key": "abc123"}
Response
{
"data": {
"settings": [
{
"key": "abc123",
"value": "xyz789"
}
]
}
}
site
Description
Load a site by id
Response
Returns a Site
Example
Query
query site(
$id: String,
$ignoreMarketingConfiguration: Boolean
) {
site(
id: $id,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration
) {
company
cps {
...CpFragment
}
id
label
latitude
longitude
scope
}
}
Variables
{
"id": "xyz789",
"ignoreMarketingConfiguration": false
}
Response
{
"data": {
"site": {
"company": "xyz789",
"cps": [Cp],
"id": "abc123",
"label": "abc123",
"latitude": 987.65,
"longitude": 987.65,
"scope": "xyz789"
}
}
}
sitesPaged
Description
Load a list of sites
Response
Returns a SitesPaged
Arguments
Name | Description |
---|---|
filter - [ConnectorFilter]
|
|
ignoreMarketingConfiguration - Boolean
|
|
pagination - PaginationFilter
|
Example
Query
query sitesPaged(
$filter: [ConnectorFilter],
$ignoreMarketingConfiguration: Boolean,
$pagination: PaginationFilter
) {
sitesPaged(
filter: $filter,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
pagination: $pagination
) {
data {
...SiteFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filter": [ConnectorFilter],
"ignoreMarketingConfiguration": true,
"pagination": PaginationFilter
}
Response
{
"data": {
"sitesPaged": {
"data": [Site],
"pagination": Pagination
}
}
}
sitesPagedLocationBased
Description
Load a list of sites with pagination based on location
Response
Returns a SitesPaged
Arguments
Name | Description |
---|---|
filter - [ConnectorFilter]
|
|
ignoreMarketingConfiguration - Boolean
|
|
location - LocationFilter
|
|
pagination - PaginationFilter
|
Example
Query
query sitesPagedLocationBased(
$filter: [ConnectorFilter],
$ignoreMarketingConfiguration: Boolean,
$location: LocationFilter,
$pagination: PaginationFilter
) {
sitesPagedLocationBased(
filter: $filter,
ignoreMarketingConfiguration: $ignoreMarketingConfiguration,
location: $location,
pagination: $pagination
) {
data {
...SiteFragment
}
pagination {
...PaginationFragment
}
}
}
Variables
{
"filter": [ConnectorFilter],
"ignoreMarketingConfiguration": true,
"location": LocationFilter,
"pagination": PaginationFilter
}
Response
{
"data": {
"sitesPagedLocationBased": {
"data": [Site],
"pagination": Pagination
}
}
}
termsAndConditions
Description
The most recent terms and conditions in device language.
Response
Returns a LegalDocument
Example
Query
query termsAndConditions {
termsAndConditions {
id
url
version
}
}
Response
{
"data": {
"termsAndConditions": {
"id": "abc123",
"url": "abc123",
"version": "xyz789"
}
}
}
verifyEmail
Description
Verify Email address
Response
Returns a VerifyEmailResponse
Arguments
Name | Description |
---|---|
email - String
|
Example
Query
query verifyEmail($email: String) {
verifyEmail(email: $email) {
message
status
}
}
Variables
{"email": "xyz789"}
Response
{
"data": {
"verifyEmail": {
"message": "abc123",
"status": 987
}
}
}
Mutations
acceptTermsAndConditions
Description
Accept the terms and conditions by uuid.
Response
Returns a TermsAndConditionsStatus!
Arguments
Name | Description |
---|---|
id - String!
|
Example
Query
mutation acceptTermsAndConditions($id: String!) {
acceptTermsAndConditions(id: $id) {
message
status
}
}
Variables
{"id": "xyz789"}
Response
{
"data": {
"acceptTermsAndConditions": {
"message": "abc123",
"status": "abc123"
}
}
}
anonymousLogin
Description
Anonymous user login authentication: This endpoint returns a session object. The session token is valid for 60 min. The refresh token is valid for a month.
Response
Returns a UserLoginAuthenticationResponse
Example
Query
mutation anonymousLogin {
anonymousLogin {
error {
...ErrorBodyFragment
}
refreshToken
sessionToken
}
}
Response
{
"data": {
"anonymousLogin": {
"error": ErrorBody,
"refreshToken": "abc123",
"sessionToken": "xyz789"
}
}
}
attemptRemoteStart
Description
Is similar to the remote start, but provides the customer with more detailed information about the current status.
CANNOT be used for roaming stations.
To get the current status after the mutation you need this query: remoteStartAttemptStatus
Response
Returns an AttemptRemoteStartResponse!
Arguments
Name | Description |
---|---|
input - AttemptRemoteStartInput!
|
Example
Query
mutation attemptRemoteStart($input: AttemptRemoteStartInput!) {
attemptRemoteStart(input: $input) {
chargeLogId
connectorId
failureReason
id
isFailure
lastSentAt
status
}
}
Variables
{"input": AttemptRemoteStartInput}
Response
{
"data": {
"attemptRemoteStart": {
"chargeLogId": "xyz789",
"connectorId": "xyz789",
"failureReason": "abc123",
"id": 4,
"isFailure": true,
"lastSentAt": "xyz789",
"status": "abc123"
}
}
}
changePassword
Description
Set new password
Response
Returns a ChangePasswordResponse
Example
Query
mutation changePassword(
$currentPassword: String,
$newPassword: String
) {
changePassword(
currentPassword: $currentPassword,
newPassword: $newPassword
) {
code
message
status
}
}
Variables
{
"currentPassword": "xyz789",
"newPassword": "abc123"
}
Response
{
"data": {
"changePassword": {
"code": 987,
"message": "abc123",
"status": "abc123"
}
}
}
createAuthenticationMedia
Description
Create an authentication media
Response
Returns an AuthenticationMediaResponse
Arguments
Name | Description |
---|---|
authenticationMedia - authenticationMediaContract!
|
Example
Query
mutation createAuthenticationMedia($authenticationMedia: authenticationMediaContract!) {
createAuthenticationMedia(authenticationMedia: $authenticationMedia) {
customerReference
id
rateId
}
}
Variables
{"authenticationMedia": authenticationMediaContract}
Response
{
"data": {
"createAuthenticationMedia": {
"customerReference": "xyz789",
"id": "xyz789",
"rateId": "abc123"
}
}
}
createPostpaidContract
Description
Create a postpaid contract
Response
Returns a ContractPostpaidResponse
Arguments
Name | Description |
---|---|
postpaidContract - creatingPostpaidContract
|
Example
Query
mutation createPostpaidContract($postpaidContract: creatingPostpaidContract) {
createPostpaidContract(postpaidContract: $postpaidContract) {
error {
...ContractErrorBodyFragment
}
message
status
}
}
Variables
{"postpaidContract": creatingPostpaidContract}
Response
{
"data": {
"createPostpaidContract": {
"error": ContractErrorBody,
"message": "abc123",
"status": "xyz789"
}
}
}
createSepaContract
Description
Create a SEPA contract
Response
Returns a ContractSepaResponse
Arguments
Name | Description |
---|---|
sepaContract - creatingSepaContract
|
Example
Query
mutation createSepaContract($sepaContract: creatingSepaContract) {
createSepaContract(sepaContract: $sepaContract) {
error {
...ContractErrorBodyFragment
}
message
status
}
}
Variables
{"sepaContract": creatingSepaContract}
Response
{
"data": {
"createSepaContract": {
"error": ContractErrorBody,
"message": "xyz789",
"status": "xyz789"
}
}
}
deleteContact
Description
Delete Contact: Deleting the current logged in user
Response
Returns a ContactDeleteResponse
Example
Query
mutation deleteContact {
deleteContact {
additionalFields {
...AdditionalRegistrationFieldFragment
}
error {
...ErrorBodyFragment
}
profile {
...ContactFragment
}
status
}
}
Response
{
"data": {
"deleteContact": {
"additionalFields": [AdditionalRegistrationField],
"error": ErrorBody,
"profile": Contact,
"status": "xyz789"
}
}
}
deleteCp
Example
Query
mutation deleteCp($id: ID!) {
deleteCp(id: $id) {
accessType
additionalFields {
...AdditionalCpFieldFragment
}
address
city
connectors {
...ConnectorFragment
}
contact {
...ContactInformationFragment
}
country
id
images {
...CpImageFragment
}
information {
...CpInfoFragment
}
isFavoured
label
latitude
longitude
publicName
site {
...SiteFragment
}
siteId
status {
...CpStatusFragment
}
zip
}
}
Variables
{"id": 4}
Response
{
"data": {
"deleteCp": {
"accessType": "INTERNAL",
"additionalFields": [AdditionalCpField],
"address": "abc123",
"city": "abc123",
"connectors": [Connector],
"contact": ContactInformation,
"country": "abc123",
"id": 4,
"images": [CpImage],
"information": CpInfo,
"isFavoured": false,
"label": "xyz789",
"latitude": 123.45,
"longitude": 123.45,
"publicName": "abc123",
"site": Site,
"siteId": "xyz789",
"status": CpStatus,
"zip": "abc123"
}
}
}
deletePostpaidContract
Description
Update a postpaid contract
Response
Returns a ContractPostpaidResponse
Arguments
Name | Description |
---|---|
postpaidContract - deletePostpaidContract
|
Example
Query
mutation deletePostpaidContract($postpaidContract: deletePostpaidContract) {
deletePostpaidContract(postpaidContract: $postpaidContract) {
error {
...ContractErrorBodyFragment
}
message
status
}
}
Variables
{"postpaidContract": deletePostpaidContract}
Response
{
"data": {
"deletePostpaidContract": {
"error": ContractErrorBody,
"message": "xyz789",
"status": "xyz789"
}
}
}
deleteSepaContract
Description
Delete a SEPA contract
Response
Returns a ContractSepaResponse
Arguments
Name | Description |
---|---|
id - String!
|
Example
Query
mutation deleteSepaContract($id: String!) {
deleteSepaContract(id: $id) {
error {
...ContractErrorBodyFragment
}
message
status
}
}
Variables
{"id": "xyz789"}
Response
{
"data": {
"deleteSepaContract": {
"error": ContractErrorBody,
"message": "abc123",
"status": "xyz789"
}
}
}
initAnonymousSession
Response
Returns a SessionAuthenticationResponse!
Example
Query
mutation initAnonymousSession {
initAnonymousSession {
refreshToken
sessionToken
}
}
Response
{
"data": {
"initAnonymousSession": {
"refreshToken": "xyz789",
"sessionToken": "abc123"
}
}
}
initDirectPaymentCharging
Response
Returns an OptileTransaction
Example
Query
mutation initDirectPaymentCharging(
$cardId: String,
$connectorId: String!,
$rateId: String!,
$ratePackageId: String
) {
initDirectPaymentCharging(
cardId: $cardId,
connectorId: $connectorId,
rateId: $rateId,
ratePackageId: $ratePackageId
) {
absoluteLink
id
link
}
}
Variables
{
"cardId": "xyz789",
"connectorId": "abc123",
"rateId": "xyz789",
"ratePackageId": "abc123"
}
Response
{
"data": {
"initDirectPaymentCharging": {
"absoluteLink": "xyz789",
"id": "xyz789",
"link": "abc123"
}
}
}
initSession
Response
Returns a SessionAuthenticationResponse!
Example
Query
mutation initSession(
$password: String!,
$username: String!
) {
initSession(
password: $password,
username: $username
) {
refreshToken
sessionToken
}
}
Variables
{
"password": "abc123",
"username": "abc123"
}
Response
{
"data": {
"initSession": {
"refreshToken": "xyz789",
"sessionToken": "abc123"
}
}
}
invalidateSession
Response
Returns a SessionInvalidationResponse!
Example
Query
mutation invalidateSession {
invalidateSession {
isInvalidated
status
}
}
Response
{
"data": {
"invalidateSession": {
"isInvalidated": false,
"status": "xyz789"
}
}
}
login
Description
User login authentication: Given username and password this endpoint returns a session object. The session token is valid for 60 min. The refresh token is valid for a month.
Response
Returns a UserLoginAuthenticationResponse
Example
Query
mutation login(
$password: String!,
$username: String!
) {
login(
password: $password,
username: $username
) {
error {
...ErrorBodyFragment
}
refreshToken
sessionToken
}
}
Variables
{
"password": "abc123",
"username": "abc123"
}
Response
{
"data": {
"login": {
"error": ErrorBody,
"refreshToken": "abc123",
"sessionToken": "xyz789"
}
}
}
reactivateUser
Description
Reactivate User
Response
Returns a ReactivateUserResponse
Arguments
Name | Description |
---|---|
email - String
|
Example
Query
mutation reactivateUser($email: String) {
reactivateUser(email: $email) {
message
status
}
}
Variables
{"email": "abc123"}
Response
{
"data": {
"reactivateUser": {
"message": "xyz789",
"status": 987
}
}
}
refreshSession
Description
Refresh user session: Providing the appropriate refresh token as an authorization bearer token, a new session object will be provided. Like with the login response, the session and refresh token are valid for 60 minutes and a month respectively.
Response
Returns a UserLoginAuthenticationResponse
Example
Query
mutation refreshSession {
refreshSession {
error {
...ErrorBodyFragment
}
refreshToken
sessionToken
}
}
Response
{
"data": {
"refreshSession": {
"error": ErrorBody,
"refreshToken": "abc123",
"sessionToken": "xyz789"
}
}
}
registerContact
Description
Create user profile: Expecting a JSON containing the users information a new account is created in the mandant
Response
Returns a ContactResponse
Arguments
Name | Description |
---|---|
additionalFields - [AdditionalRegistrationFieldInput]
|
|
contactProfile - RegisteringContactProfile
|
Example
Query
mutation registerContact(
$additionalFields: [AdditionalRegistrationFieldInput],
$contactProfile: RegisteringContactProfile
) {
registerContact(
additionalFields: $additionalFields,
contactProfile: $contactProfile
) {
additionalFields {
...AdditionalRegistrationFieldFragment
}
error {
...ErrorBodyFragment
}
profile {
...ContactFragment
}
}
}
Variables
{
"additionalFields": [AdditionalRegistrationFieldInput],
"contactProfile": RegisteringContactProfile
}
Response
{
"data": {
"registerContact": {
"additionalFields": [AdditionalRegistrationField],
"error": ErrorBody,
"profile": Contact
}
}
}
registerContactAndLogin
Description
Create user profile: Expecting a JSON containing the users information a new account is created in the mandant
Response
Returns a ContactSession
Arguments
Name | Description |
---|---|
additionalFields - [AdditionalRegistrationFieldInput]
|
|
contactProfile - RegisteringContactProfile
|
Example
Query
mutation registerContactAndLogin(
$additionalFields: [AdditionalRegistrationFieldInput],
$contactProfile: RegisteringContactProfile
) {
registerContactAndLogin(
additionalFields: $additionalFields,
contactProfile: $contactProfile
) {
contact {
...ContactResponseFragment
}
session {
...UserLoginAuthenticationResponseFragment
}
}
}
Variables
{
"additionalFields": [AdditionalRegistrationFieldInput],
"contactProfile": RegisteringContactProfile
}
Response
{
"data": {
"registerContactAndLogin": {
"contact": ContactResponse,
"session": UserLoginAuthenticationResponse
}
}
}
registerPaymentMethod
Response
Returns an OptileTransaction
Example
Query
mutation registerPaymentMethod(
$customerReference: String,
$rateId: String!
) {
registerPaymentMethod(
customerReference: $customerReference,
rateId: $rateId
) {
absoluteLink
id
link
}
}
Variables
{
"customerReference": "xyz789",
"rateId": "xyz789"
}
Response
{
"data": {
"registerPaymentMethod": {
"absoluteLink": "abc123",
"id": "abc123",
"link": "abc123"
}
}
}
remoteStart
Description
Start a remote charging process
Response
Returns a RemoteStartResponse
Arguments
Name | Description |
---|---|
authorization - Authorization
|
|
connector - String
|
Example
Query
mutation remoteStart(
$authorization: Authorization,
$connector: String
) {
remoteStart(
authorization: $authorization,
connector: $connector
) {
code
id
message
session
status
transaction
}
}
Variables
{
"authorization": Authorization,
"connector": "abc123"
}
Response
{
"data": {
"remoteStart": {
"code": 987,
"id": "abc123",
"message": "abc123",
"session": "abc123",
"status": "xyz789",
"transaction": "abc123"
}
}
}
remoteStartWithoutInvoicing
Description
Start a remote charging process without invoicing
Response
Returns a RemoteStartResponse
Arguments
Name | Description |
---|---|
authorization - Authorization
|
|
connector - String
|
Example
Query
mutation remoteStartWithoutInvoicing(
$authorization: Authorization,
$connector: String
) {
remoteStartWithoutInvoicing(
authorization: $authorization,
connector: $connector
) {
code
id
message
session
status
transaction
}
}
Variables
{
"authorization": Authorization,
"connector": "abc123"
}
Response
{
"data": {
"remoteStartWithoutInvoicing": {
"code": 987,
"id": "xyz789",
"message": "xyz789",
"session": "xyz789",
"status": "xyz789",
"transaction": "abc123"
}
}
}
remoteStop
Description
Stop a remote charging process
Response
Returns a RemoteStopResponse
Arguments
Name | Description |
---|---|
transaction - String
|
Example
Query
mutation remoteStop($transaction: String) {
remoteStop(transaction: $transaction) {
code
message
status
title
}
}
Variables
{"transaction": "abc123"}
Response
{
"data": {
"remoteStop": {
"code": 123,
"message": "abc123",
"status": "abc123",
"title": "xyz789"
}
}
}
renewSession
Response
Returns a SessionAuthenticationResponse!
Example
Query
mutation renewSession {
renewSession {
refreshToken
sessionToken
}
}
Response
{
"data": {
"renewSession": {
"refreshToken": "abc123",
"sessionToken": "xyz789"
}
}
}
setFavouriteCps
Description
Update the list of favourite Charge Points for the current user
Response
Returns [CpFavouredStatus]
Arguments
Name | Description |
---|---|
ids - [String]!
|
Example
Query
mutation setFavouriteCps($ids: [String]!) {
setFavouriteCps(ids: $ids) {
id
isFavoured
}
}
Variables
{"ids": ["xyz789"]}
Response
{
"data": {
"setFavouriteCps": [
{"id": "abc123", "isFavoured": true}
]
}
}
unsetFavouriteCps
Description
Removing the favourite Charge Points for the current user
Response
Returns [CpFavouredStatus]
Arguments
Name | Description |
---|---|
ids - [String]!
|
Example
Query
mutation unsetFavouriteCps($ids: [String]!) {
unsetFavouriteCps(ids: $ids) {
id
isFavoured
}
}
Variables
{"ids": ["abc123"]}
Response
{
"data": {
"unsetFavouriteCps": [
{"id": "xyz789", "isFavoured": true}
]
}
}
updateCard
Response
Returns an UpdateCardResponse!
Arguments
Name | Description |
---|---|
input - UpdateCardInput!
|
Example
Query
mutation updateCard($input: UpdateCardInput!) {
updateCard(input: $input) {
expiryDate
id
label
message
number
status
tagId
type
}
}
Variables
{"input": UpdateCardInput}
Response
{
"data": {
"updateCard": {
"expiryDate": "abc123",
"id": "4",
"label": "abc123",
"message": "abc123",
"number": "xyz789",
"status": "xyz789",
"tagId": "xyz789",
"type": "xyz789"
}
}
}
updateCardBillingContact
Description
Update card billing contact
Response
Returns an UpdateCardBillingContactResponse
Example
Query
mutation updateCardBillingContact(
$billingContactId: String!,
$cardId: String!
) {
updateCardBillingContact(
billingContactId: $billingContactId,
cardId: $cardId
) {
message
status
}
}
Variables
{
"billingContactId": "xyz789",
"cardId": "abc123"
}
Response
{
"data": {
"updateCardBillingContact": {
"message": "xyz789",
"status": "abc123"
}
}
}
updateContact
Description
Update user profile: Providing a user ID and user JSON, all set fields with a non null value will be updated for user.
Response
Returns a ContactResponse
Arguments
Name | Description |
---|---|
contactProfile - ContactProfile!
|
Example
Query
mutation updateContact($contactProfile: ContactProfile!) {
updateContact(contactProfile: $contactProfile) {
additionalFields {
...AdditionalRegistrationFieldFragment
}
error {
...ErrorBodyFragment
}
profile {
...ContactFragment
}
}
}
Variables
{"contactProfile": ContactProfile}
Response
{
"data": {
"updateContact": {
"additionalFields": [AdditionalRegistrationField],
"error": ErrorBody,
"profile": Contact
}
}
}
updatePostpaidContract
Description
Update a postpaid contract
Response
Returns a ContractPostpaidResponse
Arguments
Name | Description |
---|---|
postpaidContract - updatePostpaidContract
|
Example
Query
mutation updatePostpaidContract($postpaidContract: updatePostpaidContract) {
updatePostpaidContract(postpaidContract: $postpaidContract) {
error {
...ContractErrorBodyFragment
}
message
status
}
}
Variables
{"postpaidContract": updatePostpaidContract}
Response
{
"data": {
"updatePostpaidContract": {
"error": ContractErrorBody,
"message": "abc123",
"status": "xyz789"
}
}
}
updateSepaContract
Description
Update a SEPA contract
Response
Returns a ContractSepaResponse
Arguments
Name | Description |
---|---|
updateSepaContract - updatingSepaContract
|
Example
Query
mutation updateSepaContract($updateSepaContract: updatingSepaContract) {
updateSepaContract(updateSepaContract: $updateSepaContract) {
error {
...ContractErrorBodyFragment
}
message
status
}
}
Variables
{"updateSepaContract": updatingSepaContract}
Response
{
"data": {
"updateSepaContract": {
"error": ContractErrorBody,
"message": "abc123",
"status": "abc123"
}
}
}
Subscriptions
feedStatusUpdate
Response
Returns a ConnectorStatus
Arguments
Name | Description |
---|---|
connectors - [ID]!
|
Example
Query
subscription feedStatusUpdate($connectors: [ID]!) {
feedStatusUpdate(connectors: $connectors) {
calculated
connectorId
ocpp
simple
}
}
Variables
{"connectors": ["4"]}
Response
{
"data": {
"feedStatusUpdate": {
"calculated": "abc123",
"connectorId": "4",
"ocpp": "abc123",
"simple": "Available"
}
}
}
Types
AccessType
Description
AccessType defines the possible states of how the station can be accessed. Typically a station is either external (e.g. via Roaming) or is a internal station.
Values
Enum Value | Description |
---|---|
|
The station is accessible via the internal infrastructure |
|
The station is accessible via an external roaming interface |
Example
"INTERNAL"
AccountDocument
Description
Details about one document.
Fields
Field Name | Description |
---|---|
documentDate - DateTime
|
The date when the document was issued |
downloadLink - String
|
A Link to download the pdf |
id - String
|
Unique Identifier in form of Int |
title - String
|
The title of the document |
type - accountDocumentType
|
The type of the document |
Example
{
"documentDate": "2007-12-03T10:15:30Z",
"downloadLink": "abc123",
"id": "xyz789",
"title": "abc123",
"type": "creditnote"
}
AccountDocumentsPaged
Description
AccountDocuments filtered by page
Fields
Field Name | Description |
---|---|
data - [AccountDocument]
|
The paged set of documents of the authenticated user. |
pagination - Pagination
|
Pagination filter |
Example
{
"data": [AccountDocument],
"pagination": Pagination
}
AdditionalCpField
AdditionalRegistrationField
AdditionalRegistrationFieldInput
Address
Fields
Field Name | Description |
---|---|
city - String
|
|
country - CountryAlpha
|
|
state - String
|
|
street - String
|
|
zip - String
|
Example
{
"city": "xyz789",
"country": "AC",
"state": "abc123",
"street": "abc123",
"zip": "xyz789"
}
AddressInput
Fields
Input Field | Description |
---|---|
city - String
|
|
country - CountryAlpha
|
|
state - String
|
|
street - String
|
|
zip - String
|
Example
{
"city": "xyz789",
"country": "AC",
"state": "abc123",
"street": "xyz789",
"zip": "xyz789"
}
AttemptRemoteStartConfig
Description
Additional configuration options for the remote start attempt.
Example
{
"markedAsInvoiced": true,
"ratePackage": "xyz789",
"stopMinutes": 123,
"validUntil": "xyz789"
}
AttemptRemoteStartInput
Fields
Input Field | Description |
---|---|
config - AttemptRemoteStartConfig
|
Optional configuration parameters. |
connectorId - String!
|
|
tagId - String!
|
Example
{
"config": AttemptRemoteStartConfig,
"connectorId": "xyz789",
"tagId": "abc123"
}
AttemptRemoteStartResponse
Fields
Field Name | Description |
---|---|
chargeLogId - String
|
The id of the chargelog related to this attempt. |
connectorId - String!
|
The connector this attempt was carried out on. |
failureReason - String
|
Message describing why this attempt did not succeed. |
id - ID!
|
|
isFailure - Boolean!
|
Indicates if this attempt was successful so far. |
lastSentAt - String
|
The last time a message was sent to the station for this attempt. |
status - String!
|
The current status of this attempt. |
Example
{
"chargeLogId": "abc123",
"connectorId": "xyz789",
"failureReason": "xyz789",
"id": "4",
"isFailure": true,
"lastSentAt": "abc123",
"status": "xyz789"
}
AuthenticationMediaResponse
Authorization
Fields
Input Field | Description |
---|---|
identifier - String!
|
|
type - AuthorizationType!
|
Example
{"identifier": "xyz789", "type": "AUTO"}
AuthorizationType
Values
Enum Value | Description |
---|---|
|
|
|
Example
"AUTO"
BankAccountResponse
Example
{
"accountHolder": "abc123",
"bank": "xyz789",
"bic": "abc123",
"iban": "xyz789"
}
Boolean
Description
The Boolean
scalar type represents true
or false
.
Example
true
Card
Fields
Field Name | Description |
---|---|
expiryDate - DateTime
|
Expiry date of the authentication media (card). |
id - String!
|
Unique identifier in form of an uuid. |
label - String
|
Label of the authentication media (card). |
number - String!
|
Number of the authentication media (card). |
rate - RateOption
|
Rate options of card |
status - CardStatus
|
Indicator whether authentication media (card) is active/inactive. |
tagId - String!
|
Unique identifier in form of an tag id. |
type - CardType
|
Type of the authentication media (card). |
Example
{
"expiryDate": "2007-12-03T10:15:30Z",
"id": "abc123",
"label": "abc123",
"number": "abc123",
"rate": RateOption,
"status": "active",
"tagId": "abc123",
"type": "default"
}
CardForChargingProcess
Fields
Field Name | Description |
---|---|
expiryDate - DateTime
|
Expiry date of the authentication media (card). |
id - String!
|
Unique identifier in form of an uuid. |
label - String
|
Label of the authentication media (card). |
number - String!
|
Number of the authentication media (card). |
rate - RateDescriptionForChargingProcess
|
Information on rate which will be applied to the charging process. |
tagId - String!
|
Unique identifier in form of an tag id. |
type - CardType
|
Type of the authentication media (card). |
Example
{
"expiryDate": "2007-12-03T10:15:30Z",
"id": "xyz789",
"label": "xyz789",
"number": "abc123",
"rate": RateDescriptionForChargingProcess,
"tagId": "xyz789",
"type": "default"
}
CardInterface
Fields
Field Name | Description |
---|---|
expiryDate - DateTime
|
Expiry date of the authentication media (card). |
id - String!
|
Unique identifier in form of an uuid. |
label - String
|
Label of the authentication media (card). |
number - String!
|
Number of the authentication media (card). |
tagId - String!
|
Unique identifier in form of an tag id. |
type - CardType
|
Type of the authentication media (card). |
Possible Types
CardInterface Types |
---|
Example
{
"expiryDate": "2007-12-03T10:15:30Z",
"id": "xyz789",
"label": "abc123",
"number": "abc123",
"tagId": "abc123",
"type": "default"
}
CardStatus
Values
Enum Value | Description |
---|---|
|
|
|
Example
"active"
CardStatusActionEnum
Description
defined values for card status actions
Values
Enum Value | Description |
---|---|
|
Example
"DEACTIVATE"
CardType
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
Example
"default"
CardsPaged
Fields
Field Name | Description |
---|---|
data - [Card]
|
|
pagination - Pagination
|
Example
{
"data": [Card],
"pagination": Pagination
}
CdrCostItem
Fields
Field Name | Description |
---|---|
description - String
|
Description of the item type |
grossAmount - Float
|
Gross amount |
grossAmountLocalCurrency - Float
|
Gross amount expressed in local currency |
netAmount - Float
|
Net amount |
netAmountLocalCurrency - Float
|
Net amount expressed in local currency |
taxAmount - Float
|
Tax amount |
taxAmountLocalCurrency - Float
|
Tax amount expressed in local currency |
taxRate - Float
|
Percentage of the tax |
Example
{
"description": "xyz789",
"grossAmount": 123.45,
"grossAmountLocalCurrency": 987.65,
"netAmount": 987.65,
"netAmountLocalCurrency": 987.65,
"taxAmount": 987.65,
"taxAmountLocalCurrency": 123.45,
"taxRate": 123.45
}
ChangePasswordResponse
ChargeLogFilterStatus
Values
Enum Value | Description |
---|---|
|
|
|
Example
"started"
ChargeLogType
Description
ToDo Add cp,card ....
Values
Enum Value | Description |
---|---|
|
Example
"contact"
Chargelog
Fields
Field Name | Description |
---|---|
authId - String!
|
The identifier with whom the charging process was authorized. |
authType - String
|
The type of autherntication media with whom the charging process was authiorized. |
calibrationDetails - String
|
The link to download calibration details. |
co2Saving - Float
|
The CO2 saving in kg CO2. |
connector - Connector!
|
The connector on which the charging process is/was running. |
cost - Cost
|
The costs of the charging process. |
dateEnd - DateTime
|
End date of the charging process. |
dateStart - DateTime
|
Start date of the charging process. |
energyConsumption - Float
|
The consumed energy in kWh. |
id - ID!
|
Unique identifier in form of an uuid. |
meterEnd - Int
|
End value of the meter. |
meterStart - Int
|
Starting value of the meter. |
rateName - String
|
Name of the used rate. |
sessionId - String
|
Id of the Session. Needed to stop the transaction |
status - String!
|
The current status of the charging process. |
Example
{
"authId": "abc123",
"authType": "xyz789",
"calibrationDetails": "abc123",
"co2Saving": 987.65,
"connector": Connector,
"cost": Cost,
"dateEnd": "2007-12-03T10:15:30Z",
"dateStart": "2007-12-03T10:15:30Z",
"energyConsumption": 123.45,
"id": "4",
"meterEnd": 123,
"meterStart": 123,
"rateName": "xyz789",
"sessionId": "xyz789",
"status": "abc123"
}
ChargelogFilter
Description
Filter for chargelogs.
Fields
Input Field | Description |
---|---|
status - ChargeLogFilterStatus
|
The current status of the charging process. |
Example
{"status": "started"}
ChargelogsPaged
Fields
Field Name | Description |
---|---|
data - [Chargelog]
|
|
pagination - Pagination
|
Example
{
"data": [Chargelog],
"pagination": Pagination
}
ChargingStatistics
Connector
Description
Connector information
Fields
Field Name | Description |
---|---|
connectorType - ConnectorType
|
|
cp - Cp
|
|
evseId - String
|
|
freeOfCharge - Boolean
|
|
id - ID!
|
|
label - String
|
|
sortOrder - String
|
|
status - ConnectorStatus
|
Example
{
"connectorType": ConnectorType,
"cp": Cp,
"evseId": "xyz789",
"freeOfCharge": true,
"id": "4",
"label": "abc123",
"sortOrder": "xyz789",
"status": ConnectorStatus
}
ConnectorFilter
Fields
Input Field | Description |
---|---|
options - [String]
|
List of filter options. |
slug - FilterType
|
Unique identifier in form of a slug. |
Example
{
"options": ["xyz789"],
"slug": "FILTER_BY_CONNECTOR_TYPE"
}
ConnectorPaged
Description
ConnectorPaged contains information about the used pagination and paginated connectors
Fields
Field Name | Description |
---|---|
data - [Connector]
|
List of connectors. |
pagination - Pagination
|
Example
{
"data": [Connector],
"pagination": Pagination
}
ConnectorStatus
Fields
Field Name | Description |
---|---|
calculated - String
|
Calculated current cp connector status |
connectorId - ID!
|
The connector’s internal ID. |
ocpp - String
|
Latest/current ocpp connector status that was received from the connector |
simple - SimpleConnectorStatus
|
Calculated current cp connector status in simplified form |
Example
{
"calculated": "abc123",
"connectorId": 4,
"ocpp": "xyz789",
"simple": "Available"
}
ConnectorType
Description
Type of connector
Fields
Field Name | Description |
---|---|
chargePointType - String
|
Charge point type of the connector (AC or DC). |
chargingFacilityType - String
|
Charging facility type of the connector. |
chargingModeType - String
|
Charging mode type of the connector. |
id - ID!
|
Internal ID of the connector type. |
label - String
|
Label of the connector's type. |
maxPowerRating - Float
|
Maximum power rating of the connector, defined in kW. |
plugType - String
|
Plug type of the connector. |
standard - String
|
Standard of the connector's type. |
Example
{
"chargePointType": "xyz789",
"chargingFacilityType": "xyz789",
"chargingModeType": "xyz789",
"id": "4",
"label": "xyz789",
"maxPowerRating": 987.65,
"plugType": "xyz789",
"standard": "abc123"
}
Contact
Description
Contact data
Fields
Field Name | Description |
---|---|
address - Address
|
|
birthday - DateTime
|
|
companyId - Int
|
|
createdAt - DateTime
|
|
displayName - String
|
|
email - String
|
|
firstName - String
|
|
gender - Gender
|
gender can be female, male, company or diverse |
id - String
|
|
isCompany - Boolean
|
isCompany is either true or false |
language - LanguageCode
|
|
mobile - String
|
|
name - String
|
|
phone - String
|
|
termsAndConditionsAccepted - Boolean
|
|
updatedAt - DateTime
|
|
vat - String
|
Example
{
"address": Address,
"birthday": "2007-12-03T10:15:30Z",
"companyId": 123,
"createdAt": "2007-12-03T10:15:30Z",
"displayName": "abc123",
"email": "abc123",
"firstName": "xyz789",
"gender": "company",
"id": "abc123",
"isCompany": false,
"language": "cs_CZ",
"mobile": "xyz789",
"name": "abc123",
"phone": "xyz789",
"termsAndConditionsAccepted": false,
"updatedAt": "2007-12-03T10:15:30Z",
"vat": "abc123"
}
ContactDeleteResponse
Description
Delete response: Informs the client if the delete was performed.
Fields
Field Name | Description |
---|---|
additionalFields - [AdditionalRegistrationField]
|
|
error - ErrorBody
|
|
profile - Contact
|
|
status - String
|
Example
{
"additionalFields": [AdditionalRegistrationField],
"error": ErrorBody,
"profile": Contact,
"status": "abc123"
}
ContactInformation
ContactProfile
Description
User profile
Fields
Input Field | Description |
---|---|
address - AddressInput
|
|
birthday - DateTime
|
|
companyId - Int
|
|
email - String
|
|
fax - String
|
|
firstName - String
|
|
gender - Gender
|
gender can be female, male, company or diverse |
id - String
|
|
isCompany - Boolean
|
isCompany is either true or false |
language - LanguageCode
|
|
mobile - String
|
|
name - String
|
|
phone - String
|
|
vat - String
|
Example
{
"address": AddressInput,
"birthday": "2007-12-03T10:15:30Z",
"companyId": 123,
"email": "xyz789",
"fax": "xyz789",
"firstName": "abc123",
"gender": "company",
"id": "xyz789",
"isCompany": true,
"language": "cs_CZ",
"mobile": "abc123",
"name": "abc123",
"phone": "xyz789",
"vat": "abc123"
}
ContactResponse
Fields
Field Name | Description |
---|---|
additionalFields - [AdditionalRegistrationField]
|
|
error - ErrorBody
|
|
profile - Contact
|
Example
{
"additionalFields": [AdditionalRegistrationField],
"error": ErrorBody,
"profile": Contact
}
ContactSession
Fields
Field Name | Description |
---|---|
contact - ContactResponse
|
|
session - UserLoginAuthenticationResponse
|
Example
{
"contact": ContactResponse,
"session": UserLoginAuthenticationResponse
}
ContractData
ContractErrorBody
Fields
Field Name | Description |
---|---|
code - String
|
|
response - ContractErrorResponse
|
Example
{
"code": "abc123",
"response": ContractErrorResponse
}
ContractErrorResponse
Fields
Field Name | Description |
---|---|
body - ContractErrorResponseStatus
|
|
status - Int
|
|
statusText - String
|
Example
{
"body": ContractErrorResponseStatus,
"status": 987,
"statusText": "abc123"
}
ContractErrorResponseStatus
ContractPaymentMethod
Description
ContractPaymentMethods data
Example
{
"applicationId": "xyz789",
"cardCreateMode": "abc123",
"createdAt": "2007-12-03T10:15:30Z",
"directPaymentMethod": "abc123",
"emp": "xyz789",
"paymentName": "xyz789",
"paymentType": "xyz789",
"termsOfServiceUrl": "xyz789",
"termsOfUseUrl": "abc123",
"updatedAt": "2007-12-03T10:15:30Z",
"uuid": "abc123"
}
ContractPostpaidResponse
Fields
Field Name | Description |
---|---|
error - ContractErrorBody
|
|
message - String
|
|
status - String
|
Example
{
"error": ContractErrorBody,
"message": "xyz789",
"status": "xyz789"
}
ContractSepaResponse
Fields
Field Name | Description |
---|---|
error - ContractErrorBody
|
|
message - String
|
|
status - String
|
Example
{
"error": ContractErrorBody,
"message": "abc123",
"status": "xyz789"
}
Cost
Example
{
"costItems": [CdrCostItem],
"currency": "xyz789",
"grossAmount": 123.45,
"grossAmountLocalCurrency": 123.45,
"tax": 123.45,
"taxAmount": 987.65,
"total": 123.45
}
CountryAlpha
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"AC"
Cp
Description
Representation of a charging station.
Fields
Field Name | Description |
---|---|
accessType - AccessType
|
Type of the access to a station which is either a internal or external connection. Depending on the access type the request is either handled only in our system or parts might be forwarded to other parties. |
additionalFields - [AdditionalCpField]
|
Additional cp fields (customisable info fields per mandant) |
address - String
|
Address (Streetname) |
city - String
|
City |
connectors - [Connector]
|
List of connectors. |
contact - ContactInformation
|
Contact information |
country - String
|
Country (3 characters) |
id - ID!
|
Unique Identifier in form of UUID4 |
images - [CpImage]
|
CP Images as array |
information - CpInfo
|
Information |
isFavoured - Boolean
|
Is CP marked as a favourite by user |
label - String
|
Human readable string representation. |
latitude - Float
|
Latitude of the position. |
longitude - Float
|
Longitude of the position. |
publicName - String
|
Public display name |
site - Site
|
Site |
siteId - String
|
Site uuid of Cp |
status - CpStatus
|
Status information |
zip - String
|
Zip code |
Example
{
"accessType": "INTERNAL",
"additionalFields": [AdditionalCpField],
"address": "abc123",
"city": "xyz789",
"connectors": [Connector],
"contact": ContactInformation,
"country": "xyz789",
"id": 4,
"images": [CpImage],
"information": CpInfo,
"isFavoured": false,
"label": "xyz789",
"latitude": 987.65,
"longitude": 123.45,
"publicName": "xyz789",
"site": Site,
"siteId": "abc123",
"status": CpStatus,
"zip": "xyz789"
}
CpCapabilities
Description
Capabilities of a charging station
Fields
Field Name | Description |
---|---|
hasRemoteCommands - Boolean!
|
The capability of the station to work with remote commands |
Example
{"hasRemoteCommands": false}
CpFavouredStatus
CpImage
Fields
Field Name | Description |
---|---|
url - String
|
Url of a cp image |
Example
{"url": "xyz789"}
CpInfo
Fields
Field Name | Description |
---|---|
additional - String
|
Additional information |
marketingDisplay - String
|
A display status, which can be configured within the backends marketing information section of a charging station |
openingTimes - OpeningTimes
|
Opening times |
payment - String
|
Payment information |
Example
{
"additional": "xyz789",
"marketingDisplay": "abc123",
"openingTimes": OpeningTimes,
"payment": "abc123"
}
CpStatus
Description
CpStatus
Fields
Field Name | Description |
---|---|
calculated - String
|
Calculated current cp status |
ocpp - String
|
Latest/current ocpp status that was received from the station |
simple - SimpleCpStatus
|
Calculated current cp status in simplified form |
Example
{
"calculated": "abc123",
"ocpp": "xyz789",
"simple": "Available"
}
CpsPaged
Description
CpsPaged contains information about the used pagination and paginated cps
Fields
Field Name | Description |
---|---|
data - [Cp]
|
|
pagination - Pagination
|
Example
{
"data": [Cp],
"pagination": Pagination
}
DateTime
Example
"2007-12-03T10:15:30Z"
DirectPaymentChargingStatus
ErrorBody
Fields
Field Name | Description |
---|---|
code - String
|
|
response - LoginErrorResponse
|
Example
{
"code": "xyz789",
"response": LoginErrorResponse
}
Filter
Fields
Field Name | Description |
---|---|
label - String
|
Description of the filter. |
options - [FilterOption]
|
List of filter options. |
slug - FilterType
|
Unique identifier in form of a slug. |
type - String
|
Information on the filter type. |
Example
{
"label": "xyz789",
"options": [FilterOption],
"slug": "FILTER_BY_CONNECTOR_TYPE",
"type": "xyz789"
}
FilterOption
Example
{
"default": true,
"icon": "xyz789",
"label": "abc123",
"slug": "abc123"
}
FilterType
Values
Enum Value | Description |
---|---|
|
|
|
|
|
Example
"FILTER_BY_CONNECTOR_TYPE"
Float
Description
The Float
scalar type represents signed double-precision fractional values as specified by IEEE 754.
Example
123.45
Gender
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
Example
"company"
HostedPaymentMethodGetSession
ID
Description
The ID
scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4"
) or integer (such as 4
) input value will be accepted as an ID.
Example
4
Int
Description
The Int
scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
123
LanguageCode
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"cs_CZ"
LegalDocument
Location
Description
Location can be a Cp or Site
It shares connectors and information.
Fields
Field Name | Description |
---|---|
connectors - [Connector]
|
|
id - String
|
|
label - String
|
|
latitude - Float
|
|
longitude - Float
|
|
type - LocationType
|
Example
{
"connectors": [Connector],
"id": "abc123",
"label": "xyz789",
"latitude": 123.45,
"longitude": 123.45,
"type": "Cp"
}
LocationFilter
LocationType
Description
Type of a location. Currently there are two.
Values
Enum Value | Description |
---|---|
|
|
|
Example
"Cp"
LocationsPaged
Description
Locations filtered with pagination.
Fields
Field Name | Description |
---|---|
locations - [Location]
|
|
pagination - Pagination
|
Example
{
"locations": [Location],
"pagination": Pagination
}
LoginErrorResponse
Fields
Field Name | Description |
---|---|
body - LoginErrorResponseStatus
|
|
status - Int
|
|
statusText - String
|
Example
{
"body": LoginErrorResponseStatus,
"status": 123,
"statusText": "xyz789"
}
LoginErrorResponseStatus
MaskedAccount
Description
detailed information about the payment method to display to the user
Example
{
"displayLabel": "abc123",
"expiryMonth": 123,
"expiryYear": 987,
"holderName": "abc123",
"number": "abc123"
}
NativePaymentMethodGetSession
Fields
Field Name | Description |
---|---|
applicablePaymentMethods - [PaymentMethod]
|
|
registeredPaymentsMethods - [PaymentMethod]
|
|
sessionId - String
|
Example
{
"applicablePaymentMethods": [PaymentMethod],
"registeredPaymentsMethods": [PaymentMethod],
"sessionId": "abc123"
}
OccupancyDays
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"ALL"
OccupancyRate
OpeningTimes
Fields
Field Name | Description |
---|---|
description - String
|
Opening times in textual format |
exceptionalClosings - [OperatingTime]
|
Exceptional closing times |
exceptionalOpenings - [OperatingTime]
|
Exceptional opening times |
regularHours - [RegularHours]
|
Structured data of opening times |
Example
{
"description": "xyz789",
"exceptionalClosings": [OperatingTime],
"exceptionalOpenings": [OperatingTime],
"regularHours": [RegularHours]
}
OperatingHours
Description
OperatingHours have the format 'hh/mm/ss'.
Defining the types as DateTime makes trouble because tests are failing. But in Sandbox DateTime is working.
Example
{
"begin": "abc123",
"end": "xyz789"
}
OperatingTime
OperationType
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"CHARGE"
OptileTransaction
Pagination
Description
Pagination information.
Additional information for pagination responses
Fields
Field Name | Description |
---|---|
isLastPage - Boolean
|
Is this page the last page of the pagination set |
limit - Int
|
Maximum number of elements (limit) set for this pagination request |
offset - Int
|
The current offset chosen for the pagination set |
totalCount - Int
|
Overall count of pagination result (total number of objects) |
Example
{"isLastPage": true, "limit": 123, "offset": 987, "totalCount": 987}
PaginationFilter
Description
Filter to do pagination requests
Example
{"limit": 123, "offset": 123}
PaymentLink
Example
{
"form": "xyz789",
"lang": "xyz789",
"localizedForm": "abc123",
"logo": "xyz789",
"operation": "xyz789",
"self": "abc123",
"validation": "abc123"
}
PaymentMethod
Description
Represents a payment card that is either registered or available for registration for current session user.
Fields
Field Name | Description |
---|---|
button - String
|
|
code - String
|
|
contractData - ContractData
|
|
deferral - String
|
|
grouping - String
|
|
iFrameHeight - Int
|
|
label - String
|
|
links - PaymentLink
|
|
maskedAccount - MaskedAccount
|
detailed information about the payment method to display to the user |
method - String
|
|
operationType - OperationType
|
|
recurrence - String
|
|
redirect - Boolean
|
|
registration - String
|
|
selected - Boolean
|
Example
{
"button": "abc123",
"code": "xyz789",
"contractData": ContractData,
"deferral": "xyz789",
"grouping": "abc123",
"iFrameHeight": 123,
"label": "xyz789",
"links": PaymentLink,
"maskedAccount": MaskedAccount,
"method": "abc123",
"operationType": "CHARGE",
"recurrence": "xyz789",
"redirect": false,
"registration": "xyz789",
"selected": false
}
PaymentMethods
Description
Response body for payment cards fetched from PSPs
Fields
Field Name | Description |
---|---|
hostedSession - HostedPaymentMethodGetSession
|
|
nativeSession - NativePaymentMethodGetSession
|
Example
{
"hostedSession": HostedPaymentMethodGetSession,
"nativeSession": NativePaymentMethodGetSession
}
RateDescriptionForChargingProcess
RateOption
RatePackage
Fields
Field Name | Description |
---|---|
amount - Float
|
|
automaticStop - Int
|
|
id - String
|
|
rate - RateOption
|
|
visibleRuntime - Int
|
Example
{
"amount": 987.65,
"automaticStop": 987,
"id": "xyz789",
"rate": RateOption,
"visibleRuntime": 123
}
ReactivateUserResponse
RegisteringContactProfile
Fields
Input Field | Description |
---|---|
address - AddressInput
|
|
birthday - DateTime
|
|
companyId - Int
|
|
email - String!
|
|
fax - String
|
|
firstName - String
|
|
gender - Gender
|
gender can be female, male, company or diverse |
isCompany - Boolean
|
isCompany is either true or false |
language - LanguageCode
|
|
mobile - String
|
|
name - String
|
|
password - String!
|
|
phone - String
|
|
title - String
|
|
vat - String
|
Example
{
"address": AddressInput,
"birthday": "2007-12-03T10:15:30Z",
"companyId": 987,
"email": "abc123",
"fax": "xyz789",
"firstName": "xyz789",
"gender": "company",
"isCompany": false,
"language": "cs_CZ",
"mobile": "abc123",
"name": "abc123",
"password": "xyz789",
"phone": "abc123",
"title": "xyz789",
"vat": "abc123"
}
RegularHours
Fields
Field Name | Description |
---|---|
operatingHours - OperatingHours
|
Structured data of operating hours |
weekday - Int
|
Weekday for regular hour definition (1 as Monday and 7 as Sunday) |
Example
{"operatingHours": OperatingHours, "weekday": 987}
RemoteStartResponse
RemoteStopResponse
SessionAuthenticationResponse
SessionInvalidationResponse
Setting
SimpleConnectorStatus
Description
Set of simple statuses which a charging connector can have
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
Example
"Available"
SimpleCpStatus
Description
Set of simple statuses which a charging station can have
Values
Enum Value | Description |
---|---|
|
|
|
|
|
Example
"Available"
Site
Example
{
"company": "abc123",
"cps": [Cp],
"id": "abc123",
"label": "xyz789",
"latitude": 123.45,
"longitude": 123.45,
"scope": "abc123"
}
SitesPaged
Fields
Field Name | Description |
---|---|
data - [Site]
|
|
pagination - Pagination
|
Example
{
"data": [Site],
"pagination": Pagination
}
String
Description
The String
scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Example
"abc123"
TermsAndConditionsStatus
TimeFrameFilter
UpdateCardBillingContactResponse
UpdateCardInput
Fields
Input Field | Description |
---|---|
cardId - String!
|
|
label - String
|
|
status - CardStatusActionEnum
|
Example
{
"cardId": "xyz789",
"label": "xyz789",
"status": "DEACTIVATE"
}
UpdateCardResponse
Fields
Field Name | Description |
---|---|
expiryDate - String
|
The set expiry date of card |
id - ID
|
|
label - String
|
The label of the card |
message - String
|
Message from the response |
number - String
|
The card number |
status - String!
|
Returns a active | inactive status of the card |
tagId - String
|
The card id |
type - String
|
The variable card type as default | roaming | virtual | simple | emsp |
Example
{
"expiryDate": "abc123",
"id": 4,
"label": "abc123",
"message": "abc123",
"number": "xyz789",
"status": "abc123",
"tagId": "abc123",
"type": "xyz789"
}
UserLoginAuthenticationResponse
VerifyEmailResponse
accountDocumentType
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"creditnote"
authenticationMediaContract
chargelogMeterValuesSummary
Description
Detailed information regarding meter values of a charging session.
Fields
Field Name | Description |
---|---|
currentPower - Int
|
current charging current |
currentPowerLastChanged - String
|
timestamp from the charging station of the latest charging current change |
currentStateOfCharge - Int
|
the current SoC of the car |
energyFirstValue - Float
|
the first energy value transmitted from the station |
energyFirstValueTime - String
|
timestamp from the charging station for the first energy value |
energyLastValue - Float
|
the latest energy value transmitted from the station |
energyLastValueTime - String
|
timestamp from the charging station for the latest energy value |
energyUpdatedAt - String
|
timestamp of the last energy update of the charging session record in our system |
initialStateOfCharge - Int
|
the initial SoC of the car |
stateOfChargeLastChanged - String
|
timestamp from the charging station of the latest SoC change |
sumEnergy - Float
|
total charged energy |
updatedAt - String
|
timestamp of the last update of the charging session record in our system |
Example
{
"currentPower": 123,
"currentPowerLastChanged": "xyz789",
"currentStateOfCharge": 987,
"energyFirstValue": 123.45,
"energyFirstValueTime": "abc123",
"energyLastValue": 987.65,
"energyLastValueTime": "xyz789",
"energyUpdatedAt": "xyz789",
"initialStateOfCharge": 123,
"stateOfChargeLastChanged": "abc123",
"sumEnergy": 123.45,
"updatedAt": "abc123"
}
creatingPostpaidContract
creatingSepaContract
Fields
Input Field | Description |
---|---|
accountHolder - String!
|
Name of the bank account owner |
bank - String!
|
Name of the bank institut. |
bic - String!
|
Business Identifier Code (SWIFT Code). |
customerReference - String
|
A text field for the customer to name his card individually. |
debitType - String!
|
Type of the debit card |
iban - String!
|
International Bank Account Number. |
id - String!
|
Id of a registered contract option. |
rateId - String!
|
RateId |
useParent - Boolean!
|
Use the parent account |
Example
{
"accountHolder": "abc123",
"bank": "xyz789",
"bic": "xyz789",
"customerReference": "abc123",
"debitType": "xyz789",
"iban": "abc123",
"id": "abc123",
"rateId": "abc123",
"useParent": true
}
deletePostpaidContract
Fields
Input Field | Description |
---|---|
id - String!
|
Id of a registered contract option. |
Example
{"id": "abc123"}
updatePostpaidContract
updatingSepaContract
Fields
Input Field | Description |
---|---|
accountHolder - String
|
Name of the bank account owner |
bank - String
|
Name of the bank institut. |
bic - String
|
Business Identifier Code (SWIFT Code). |
customerReference - String
|
A text field for the customer to name his card individually. |
iban - String
|
International Bank Account Number. |
id - String!
|
Uuid of a registered contract option. |
Example
{
"accountHolder": "xyz789",
"bank": "abc123",
"bic": "abc123",
"customerReference": "abc123",
"iban": "abc123",
"id": "abc123"
}