Skip to main content

Objects

In this section

Objects

Objects in GraphQL represent the resources you can access. An object can contain a list of fields, which are specifically typed.

APIBrownoutEdge

A Relay edge containing a APIBrownout and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (APIBrownout)

The item at the end of the edge

Example

{
  "node": APIBrownout,
  "cursor": "abc123"
}

APIExceptionConnectionTypeEdge

A Relay edge containing a APIExceptionConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (APIExceptionType)

The item at the end of the edge

Example

{
  "node": APIExceptionType,
  "cursor": "abc123"
}

AcceptGoodsQuote

The possible errors that can be raised are:

  • KT-CT-8223: Unauthorized.
  • KT-CT-8201: Received an invalid quoteId.
  • KT-CT-8224: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

goodsPurchase (GoodsPurchase)

Goods purchase created.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "goodsPurchase": GoodsPurchase
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([AccountApplicationConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": AccountApplicationConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

AccountApplicationConnectionTypeEdge

A Relay edge containing a AccountApplicationConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (AccountApplicationType)

The item at the end of the edge

Example

{
  "node": AccountApplicationType,
  "cursor": "abc123"
}

Fields

NameDescription

coolingOffEndDate (Date)

Last day of the cooling off period. Barring changes or objections, the account will be gained on the next business day after this date. This value will only be returned for current applications.

dateOfSale (Date)

Date at which this account decided to switch to us.

isMigrated (Boolean)

Whether this account application represents a migration into the current system or a regular gain.

migrationSource (String)

The source system for a migrated account. This could be the previous supplier or the previous account management system.

salesChannel (String!)

salesSubchannel (String)

The sales subchannel used when signing up. This could for example be a price comparison site.

status (AccountApplicationStatus!)

Example

{
  "status": "CURRENT",
  "salesChannel": "abc123",
  "salesSubchannel": "abc123",
  "dateOfSale": "2020-01-01",
  "coolingOffEndDate": "2020-01-01",
  "isMigrated": true,
  "migrationSource": "abc123"
}

Fields

NameDescription

campaignExpiryDate (Date)

The date on which the associated campaign itself concludes.

expiryDate (Date)

The date on which the account's participation in the campaign ends.

name (String)

The name of the campaign.

slug (String)

The slug of the campaign.

startDate (Date)

The date that the account's link to the campaign started.

Example

{
  "campaignExpiryDate": "2020-01-01",
  "name": "abc123",
  "slug": "abc123",
  "expiryDate": "2020-01-01",
  "startDate": "2020-01-01"
}

Fields

NameDescription

data (JSONString)

A JSON object containing unstructured data about the account charge.

updatedAt (DateTime)

The date and time the metadata was last updated.

Example

{
  "data": {"key": "value"},
  "updatedAt": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

cclAmount (BigInt)

The climate change levy amount of the charge.

displayNote (String)

The display note for the charge.

grossAmount (BigInt)

The gross amount of the charge.

id (ID)

The ID of the account charge.

metadata (AccountChargeMetadataType)

netAmount (BigInt)

The net amount of the charge.

note (String)

The note for the charge.

reason (String)

The reason for the charge.

salesTaxAmount (BigInt)

The sales tax amount of the charge.

Example

{
  "id": "abc123",
  "netAmount": 1,
  "grossAmount": 1,
  "salesTaxAmount": 1,
  "cclAmount": 1,
  "reason": "abc123",
  "note": "abc123",
  "displayNote": "abc123",
  "metadata": AccountChargeMetadataType
}

Fields

NameDescription

data (JSONString!)

updatedAt (DateTime!)

Example

{
  "data": {"key": "value"},
  "updatedAt": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

grossAmount (BigInt!)

id (ID!)

metadata (AccountCreditMetadataType)

netAmount (BigInt!)

note (String!)

reason (String!)

salesTaxAmount (BigInt!)

Example

{
  "id": "abc123",
  "grossAmount": 1,
  "netAmount": 1,
  "salesTaxAmount": 1,
  "note": "abc123",
  "reason": "abc123",
  "metadata": AccountCreditMetadataType
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([AccountEventConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": AccountEventConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

AccountEventConnectionTypeEdge

A Relay edge containing a AccountEventConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (AccountEvent)

The item at the end of the edge

Example

{
  "node": EmailEventType,
  "cursor": "abc123"
}

Fields

NameDescription

category (String!)

fetchUrl (String)

filename (String!)

id (ID!)

The ID of the object

isReady (Boolean)

Is the file ready for use / downloadable?

isUploaded (Boolean)

Is the file uploaded to S3?

sizeInBytes (Int)

Example

{
  "id": "abc123",
  "filename": "abc123",
  "category": "abc123",
  "isUploaded": true,
  "isReady": true,
  "fetchUrl": "abc123",
  "sizeInBytes": 1
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([AccountFileAttachmentConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": AccountFileAttachmentConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

AccountFileAttachmentConnectionTypeEdge

A Relay edge containing a AccountFileAttachmentConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (AccountFileAttachment)

The item at the end of the edge

Example

{
  "node": AccountFileAttachment,
  "cursor": "abc123"
}

Fields

NameDescription

isEligibleForIo (Boolean)

Whether account is eligible to register devices with Intelligent Octopus or not.

Example

{
  "isEligibleForIo": true
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([AccountPaymentConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": AccountPaymentConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

AccountPaymentConnectionTypeEdge

A Relay edge containing a AccountPaymentConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (AccountPaymentType)

The item at the end of the edge

Example

{
  "node": AccountPaymentType,
  "cursor": "abc123"
}

Fields

NameDescription

amount (BigInt!)

Amount of payment in pence

id (ID!)

paymentDate (Date!)

The date this payment is scheduled to be debited

reference (String!)

status (AccountPaymentStatusOptions)

The current status of the payment.

surchargeAmount (Int)

Surcharge amount generated by this payment.

transactionType (AccountPaymentTransactionTypeChoices)

The transaction type of the payment.

Example

{
  "id": "abc123",
  "amount": 1,
  "paymentDate": "2020-01-01",
  "reference": "abc123",
  "transactionType": "DD_FIRST_COLLECTION",
  "status": "SCHEDULED",
  "surchargeAmount": 1
}

Fields

NameDescription

account (AccountType!)

createdAt (DateTime!)

namespace (String!)

updatedAt (DateTime!)

value (String!)

Example

{
  "namespace": "abc123",
  "value": "abc123",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "updatedAt": "2020-01-01T00:00:00.000Z",
  "account": AccountType
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([AccountRepaymentConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": AccountRepaymentConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

AccountRepaymentConnectionTypeEdge

A Relay edge containing a AccountRepaymentConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (AccountRepaymentType)

The item at the end of the edge

Example

{
  "node": AccountRepaymentType,
  "cursor": "abc123"
}

Fields

NameDescription

amount (BigInt!)

Amount of payment in pence

id (ID!)

paymentDate (Date!)

The date this payment is scheduled to be debited

status (AccountRepaymentStatusOptions)

The current status of the repayment.

Example

{
  "id": "abc123",
  "amount": 1,
  "paymentDate": "2020-01-01",
  "status": "REQUESTED"
}

Fields

NameDescription

accountType (AccountTypeChoices)

The type of account.

activeHardshipAgreements ([HardshipAgreementType])

List of active hardship agreements for the user when isinhardship is True.

activeReferralSchemes (ReferralSchemeTypes)

The referral schemes currently active for this account.

address (RichAddressType)

The billing address of this account, stored in the new libaddressinput-based format.

Note that name and organization are very unlikely to be supplied here; the billing_name field on the account itself is generally used for that purpose instead.

allProperties ([PropertyType])

All properties linked to the account - past, present and future.

annualStatements (AnnualStatementConnectionTypeConnection)

Fetch annual statements for the account.

applications (AccountApplicationConnectionTypeConnection)

Applications by this account to become our customer. More recent applications will be listed first.

assistanceAgreements ([AssistanceAgreementType])

Assistance agreements for account.

balance (Int!)

The current account balance.

bill (BillInterface)

Fetch a specific issued bill (invoice/statement) for the account.

billingAddress (String)

The billing address of the account.

billingAddressLine1 (String)

billingAddressLine2 (String)

billingAddressLine3 (String)

billingAddressLine4 (String)

billingAddressLine5 (String)

billingAddressPostcode (String)

billingCountryCode (String)

billingDeliveryPointIdentifier (String)

billingEmail (String)

The billing email of the account.

billingName (String)

The billing name of the account.

billingOptions (BillingOptionsType)

Information about the account's billing cycle.

billingSubName (String)

The billing sub name of the account.

bills (BillConnectionTypeConnection)

Fetch issued bills (invoices/statements) for the account.

brand (String)

The brand of the account.

business (BusinessType)

Business info related to a business account.

businessType (BusinessTypeOptions)

The company type of a business account.

Deprecated

The 'businessType' field is deprecated.

Use `business.businessType` instead

- Marked as deprecated on 2022-03-09.
- Will be removed on 2024-01-01.

campaigns ([AccountCampaignType])

The campaigns associated with an account.

canRequestRefund (Boolean)

Whether the account can request a credit refund.

commsDeliveryPreference (CommsDeliveryPreference)

The method the account has specified they prefer we contact them.

communicationDeliveryPreference (String)

Deprecated

The 'communicationDeliveryPreference' field is deprecated.

Use `commsDeliveryPreference` instead

- Marked as deprecated on 2022-05-27.
- Will be removed on 2024-01-01.

consents ([ConsentType!]!)

Consents linked to this account.

contributionAgreements ([ContributionAgreementType])

Contribution agreements for account.

createdAt (DateTime)

The datetime that the account was originally created.

debtCollectionProceedings ([DebtCollectionProceedingType])

Debt collection proceedings for account.

directDebitInstructions (DirectDebitInstructionConnectionTypeConnection)

The direct debit instructions of the account

documentAccessibility (DocumentAccessibilityChoices)

The document accessibility preference of the account.

electricityBalance (String)

The latest balance of the electricity MaLo ledger.

events (AccountEventConnectionTypeConnection)

The account events that were recorded for the account.

fileAttachments ([AccountFileAttachment])

Files attached to this account.

gasBalance (String)

The latest balance of the gas MaLo ledger.

id (ID!)

isInHardship (Boolean)

True if there is an active Hardship Agreement for this account. False otherwise.

ledgers ([LedgerType])

Ledgers provide the foundation of bookkeeping functionality. Similar to a bank account, they allow us to keep track of financial activity on a particular customer account.

maximumRefund (MaximumRefundType)

The maximum amount a customer is allowed to request as a refund and the reason why that's the maximum amount.

metadata ([Metadata])

Metadata associated with the account.

notes ([AccountNoteType])

Notes for the account.

number (String)

A code that uniquely identifies the account.

overdueBalance (Int)

The current account overdue balance.

paginatedFileAttachments (AccountFileAttachmentConnectionTypeConnection)

Files attached to this account.

paginatedPaymentForecast (PaymentForecastConnectionTypeConnection)

Paginated payment forecasts for an account. Starts from today's date (inclusive). The interface supports last but does not guarantee 'lastness'.

paymentForecast ([PaymentForecastType])

A list displaying the payment forecast for an account. The list starts from today's date (inclusive).

Deprecated

The 'paymentForecast' field is deprecated.

Please use 'paginatedPaymentForecast' instead.

- Marked as deprecated on 2024-01-03.
- Will be removed on 2025-01-01.

paymentSchedules (PaymentScheduleConnectionTypeConnection)

The schedules that describe how we would expect to take payments for an account on a given month.

payments (AccountPaymentConnectionTypeConnection)

The payments made into an account from a payment instruction.

portfolio (PortfolioType)

The portfolio this account is linked to.

preferredLanguageForComms (String)

The language that the account preferred for communications.

properties ([PropertyType])

Properties linked to the account now and in the future.

property (PropertyType)

Fetch a specific property linked to the account.

provisionalTransactions (ProvisionalTransactionConnectionTypeConnection)

references ([AccountReferenceType])

Account references linked to this account.

referrals (ReferralConnectionTypeConnection)

The referrals created by this account.

referralsCreated (Int)

Number of referrals created by this account.

repayments (AccountRepaymentConnectionTypeConnection)

The repayments that have been requested for this account.

requestRefundEligibility (RequestRefundEligibilityType)

Details about the eligibility status for requesting a refund.

rewards ([RewardType])

The rewards applied to this account.

splitBillingAddress ([String])

List of billing address lines.

status (AccountStatus)

The current status of the account.

transactions (TransactionConnectionTypeConnection)

Fetch transactions that have taken place on the account.

urn (String)

Unique reference number from a 3rd party enrolment.

users ([AccountUserType!]!)

Example

{
  "id": "abc123",
  "number": "abc123",
  "status": "PENDING",
  "paymentSchedules": PaymentScheduleConnectionTypeConnection,
  "users": AccountUserType,
  "brand": "abc123",
  "balance": 1,
  "overdueBalance": 1,
  "urn": "abc123",
  "billingName": "abc123",
  "billingSubName": "abc123",
  "billingEmail": "abc123",
  "billingAddress": "abc123",
  "billingAddressLine1": "abc123",
  "billingAddressLine2": "abc123",
  "billingAddressLine3": "abc123",
  "billingAddressLine4": "abc123",
  "billingAddressLine5": "abc123",
  "billingAddressPostcode": "abc123",
  "billingCountryCode": "abc123",
  "billingDeliveryPointIdentifier": "abc123",
  "splitBillingAddress": ["abc123"],
  "address": RichAddressType,
  "portfolio": PortfolioType,
  "ledgers": [LedgerType],
  "metadata": [Metadata],
  "canRequestRefund": true,
  "requestRefundEligibility": RequestRefundEligibilityType,
  "payments": AccountPaymentConnectionTypeConnection,
  "repayments": AccountRepaymentConnectionTypeConnection,
  "paymentForecast": [PaymentForecastType],
  "paginatedPaymentForecast": PaymentForecastConnectionTypeConnection,
  "referrals": ReferralConnectionTypeConnection,
  "referralsCreated": 1,
  "rewards": [RewardType],
  "activeReferralSchemes": ReferralSchemeTypes,
  "transactions": TransactionConnectionTypeConnection,
  "provisionalTransactions": ProvisionalTransactionConnectionTypeConnection,
  "annualStatements": AnnualStatementConnectionTypeConnection,
  "bills": BillConnectionTypeConnection,
  "billingOptions": BillingOptionsType,
  "bill": BillInterface,
  "directDebitInstructions": DirectDebitInstructionConnectionTypeConnection,
  "events": AccountEventConnectionTypeConnection,
  "applications": AccountApplicationConnectionTypeConnection,
  "accountType": "BUSINESS",
  "businessType": "SOLE_TRADER",
  "business": BusinessType,
  "commsDeliveryPreference": "EMAIL",
  "communicationDeliveryPreference": "abc123",
  "documentAccessibility": "LARGE_PRINT",
  "references": [AccountReferenceType],
  "fileAttachments": [AccountFileAttachment],
  "paginatedFileAttachments": AccountFileAttachmentConnectionTypeConnection,
  "maximumRefund": MaximumRefundType,
  "campaigns": [AccountCampaignType],
  "isInHardship": true,
  "activeHardshipAgreements": [HardshipAgreementType],
  "notes": [AccountNoteType],
  "contributionAgreements": [ContributionAgreementType],
  "assistanceAgreements": [AssistanceAgreementType],
  "debtCollectionProceedings": [DebtCollectionProceedingType],
  "createdAt": "2020-01-01T00:00:00.000Z",
  "preferredLanguageForComms": "abc123",
  "consents": ConsentType,
  "properties": [PropertyType],
  "allProperties": [PropertyType],
  "property": PropertyType,
  "electricityBalance": "abc123",
  "gasBalance": "abc123"
}

AccountUserCommsPreferences

Information about the preferences set up for a user.

Fields

NameDescription

emailFormat (EmailFormats)

What format the user would like to receive their emails in.

fontSizeMultiplier (Float)

This setting allows the user to adjust the default font size of the communications sent to them.

isOptedInMeterReadingConfirmations (Boolean)

Whether the user has opted in to receive meter reading confirmation emails.

isOptedInToClientMessages (Boolean)

Whether a user has opted in to receive messages from the client or client group. For example, for Octopus Energy this describes whether a user is opted in to offers from Octopus Investments.

isOptedInToOfferMessages (Boolean)

Whether a user has opted in to receive messages offering discounts or other services not directly related to the services the client provides.

isOptedInToRecommendedMessages (Boolean)

Whether a user has opted in to receive messages we recommend they read, but are not vital to the utilities the client provides. For example, these could be reminders that the client will take a payment.

isOptedInToSmsMessages (Boolean)

Whether the user has opted in to receive SMS messages.

isOptedInToThirdPartyMessages (Boolean)

Whether a user has opted in to receive messages from the client's preferred third parties.

isOptedInToUpdateMessages (Boolean)

Whether a user has opted in to receive messages updating them on client activities.

isUsingInvertedEmailColours (Boolean)

Whether a user has opted to have inverted colours in their emails. This is currently only relevant to the Octopus Energy brand, whose emails have a dark background by default.

preferredHoldMusic (Songs)

Song which will be used as hold music for the user.

Example

{
  "isOptedInToClientMessages": true,
  "isOptedInToOfferMessages": true,
  "isOptedInToRecommendedMessages": true,
  "isOptedInToUpdateMessages": true,
  "isOptedInToThirdPartyMessages": true,
  "emailFormat": "TEXT",
  "isUsingInvertedEmailColours": true,
  "fontSizeMultiplier": 1.0,
  "isOptedInMeterReadingConfirmations": true,
  "isOptedInToSmsMessages": true,
  "preferredHoldMusic": "NO_SONG_PREFERRED"
}

Fields

NameDescription

namespace (String)

The namespace for the property.

value (String)

The property value.

Example

{
  "namespace": "abc123",
  "value": "abc123"
}

AccountUserRoleType

The role a user has in association with one account.

Fields

NameDescription

account (AccountType!)

id (ID!)

role (RoleString)

The account role.

user (AccountUserType!)

Example

{
  "id": "abc123",
  "user": AccountUserType,
  "account": AccountType,
  "role": RoleString
}

AccountUserType

User objects are the core of the authentication system. They typically represent a customer who manages a portfolio of one or more accounts.

Fields

NameDescription

accountUserRoles ([AccountUserRoleType])

List of roles a user has for each account they're linked to.

accounts ([AccountInterface])

List of accounts that the user is linked to either via portfolio role or account role.

alternativePhoneNumbers ([String])

List of alternative phone numbers for the account user.

consents ([ConsentType!]!)

Consents linked to this user.

dateOfBirth (Date)

AccountUser's date of birth.

details ([AccountUserDetailType])

List of details linked to this user.

displayName (String)

We recommend you use fullName instead of this field.

Deprecated

The 'displayName' field is deprecated.

Please use fullName instead of this field.

- Marked as deprecated on 2019-12-11.
- Will be removed on 2024-01-01.

email (String!)

familyName (String!)

firstName (String)

We recommend you use preferredName or fullName instead of this field.

Deprecated

The 'firstName' field is deprecated.

Use 'givenName' instead.

- Marked as deprecated on 2020-09-23.
- Will be removed on 2023-06-05.

fullName (String)

The user's full name.

givenName (String!)

hasFamilyIssues (Boolean)

Whether there are family issues.

id (ID!)

isDeceased (Boolean!)

Designates whether this user is deceased.

isInHardship (Boolean)

True if user is linked to an account with an active hardship agreement.

landline (String!)

landlinePhoneNumber (String)

The user's landline phone number.

Deprecated

The 'landlinePhoneNumber' field is deprecated.

Use 'landline' instead.

- Marked as deprecated on 2021-03-22.
- Will be removed on 2024-01-01.

lastName (String)

We recommend you use preferredName or fullName instead of this field.

Deprecated

The 'lastName' field is deprecated.

Use 'familyName' instead.

- Marked as deprecated on 2020-09-23.
- Will be removed on 2023-06-05.

liveSecretKey (String)

The user's secret key to access the Developer API.

mobile (String!)

portfolioId (ID)

We recommend you use portfolioIds instead of this field.

Deprecated

The 'portfolioId' field is deprecated.

Please use 'portfolioIds' instead.

- Marked as deprecated on 2022-08-04.
- Will be removed on 2024-01-01.

portfolioIds ([ID])

List of portfolio ids that the user is linked to via their portfolio roles.

portfolioUserRoles ([PortfolioUserRoleType])

List of roles a user has for each portfolio they're linked to.

portfolios (PortfolioConnectionTypeConnection)

List of portfolios that the user is linked to via their portfolio roles.

preferences (AccountUserCommsPreferences)

preferredName (String)

The user's preferred name.

pronouns (String)

The user's pronouns e.g. 'she/her', 'he/him', 'they/them'.

specialCircumstances (SpecialCircumstancesType)

title (String)

Example

{
  "id": "abc123",
  "accounts": AccountInterface,
  "givenName": "abc123",
  "familyName": "abc123",
  "email": "abc123",
  "mobile": "abc123",
  "landline": "abc123",
  "title": "abc123",
  "pronouns": "abc123",
  "isDeceased": true,
  "liveSecretKey": "abc123",
  "displayName": "abc123",
  "firstName": "abc123",
  "lastName": "abc123",
  "fullName": "abc123",
  "preferredName": "abc123",
  "portfolioId": "abc123",
  "portfolioIds": ["abc123"],
  "portfolios": PortfolioConnectionTypeConnection,
  "specialCircumstances": SpecialCircumstancesType,
  "preferences": AccountUserCommsPreferences,
  "dateOfBirth": "2020-01-01",
  "landlinePhoneNumber": "abc123",
  "alternativePhoneNumbers": ["abc123"],
  "hasFamilyIssues": true,
  "isInHardship": true,
  "accountUserRoles": [AccountUserRoleType],
  "portfolioUserRoles": [PortfolioUserRoleType],
  "details": [AccountUserDetailType],
  "consents": ConsentType
}

AddCampaignToAccount

The possible errors that can be raised are:

  • KT-CT-4123: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

campaignAdded (Boolean)

Whether the campaign was successfully added.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "campaignAdded": true
}

Fields

NameDescription

agreedAt (DateTime)

The datetime when the agreement was agreed.

cosLossStatus (String)

The status of an attached cos loss process.

estimatedAnnualConsumption (Int)

The annual consumption given by the customer in kWh.

estimatedMonthlyBillInEuros (Decimal)

The estimated monthly bill in €.

id (Int)

isActive (Boolean)

Whether the agreement is active.

isAffectedByPriceBrake (Boolean)

Whether the agreement is affected by the price brakes.

isRevoked (Boolean)

Whether the agreement is revoked.

isTerminated (Boolean)

Whether the agreement is terminated.

monthlyStandingCharge (Decimal)

The monthly standing charge in €.

Deprecated

The 'monthlyStandingCharge' field is deprecated.

Use standing_charge_gross_rate_information instead.

- Marked as deprecated on 2023-08-14.
- Will be removed on 2024-01-01.

netMonthlyStandingCharge (Decimal)

The net monthly standing charge in €.

product (Product)

standingChargeGrossRateInformation ([GrossRateInformation])

A list of gross rate information which is relevant to the standing charge (€/month).

unitRateGrossRateInformation ([GrossRateInformation])

A list of the gross rate information which is relevant to the unit rate (ct/kWh).

Deprecated

The 'unitRateGrossRateInformation' field is deprecated.

Use unit_rate_information instead

- Marked as deprecated on 2023-08-14.
- Will be removed on 2024-01-01.

unitRateInformation (UnitRateInformation!)

The unit rate information.

unitRatePerKwh (Decimal)

The unit rate per kWh in €.

Deprecated

The 'unitRatePerKwh' field is deprecated.

Use unit_rate_information instead.

- Marked as deprecated on 2023-08-14.
- Will be removed on 2024-01-01.

validFrom (DateTime)

The datetime when the agreement is valid from.

validTo (DateTime)

The datetime when the agreement is valid to.

Example

{
  "id": 1,
  "product": Product,
  "monthlyStandingCharge": 1.0,
  "netMonthlyStandingCharge": 1.0,
  "standingChargeGrossRateInformation": [GrossRateInformation],
  "unitRatePerKwh": 1.0,
  "unitRateGrossRateInformation": [GrossRateInformation],
  "unitRateInformation": SimpleProductUnitRateInformation,
  "estimatedMonthlyBillInEuros": 1.0,
  "estimatedAnnualConsumption": 1,
  "validFrom": "2020-01-01T00:00:00.000Z",
  "validTo": "2020-01-01T00:00:00.000Z",
  "agreedAt": "2020-01-01T00:00:00.000Z",
  "isRevoked": true,
  "isActive": true,
  "isTerminated": true,
  "cosLossStatus": "abc123",
  "isAffectedByPriceBrake": true
}

AlreadyLinkedError

Returned when an account already has a LINE account linked to it.

Fields

NameDescription

type (LineLinkErrorType!)

The type of error that occurred.

Example

{
  "type": "NO_MATCHING_LINE_LINK"
}

AmendPayment

The possible errors that can be raised are:

  • KT-CT-3924: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

payment (AccountPaymentType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "payment": AccountPaymentType
}

AnimationType

A media element containing an animation, such as a Lottie.

Fields

NameDescription

accessibilityHidden (Boolean)

Whether the element is hidden from view.

accessibilityLabel (String)

Accessible description of the element.

horizontalAlignment (Alignment)

The horizontal alignment of the media.

id (ID)

Unique identifier of the object.

mediaUrl (String!)

The resource URL of the media.

typename (String)

The name of the object's type.

width (ItemSizeType)

The measurement of the element.

Example

{
  "width": FractionSizeType,
  "mediaUrl": "abc123",
  "horizontalAlignment": "START",
  "accessibilityHidden": true,
  "accessibilityLabel": "abc123",
  "id": "abc123",
  "typename": "abc123"
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([AnnualStatementConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": AnnualStatementConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

AnnualStatementConnectionTypeEdge

A Relay edge containing a AnnualStatementConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (AnnualStatementType)

The item at the end of the edge

Example

{
  "node": AnnualStatementType,
  "cursor": "abc123"
}

AnnualStatementType

Annual statements that are sent to the account. They summarize important information about usage and tariffs.

Fields

NameDescription

id (ID)

pdfUrl (String)

periodEndsAt (DateTime!)

periodStartsAt (DateTime!)

Example

{
  "periodStartsAt": "2020-01-01T00:00:00.000Z",
  "periodEndsAt": "2020-01-01T00:00:00.000Z",
  "id": "abc123",
  "pdfUrl": "abc123"
}

AnnulOrder

Annul an order before a supply start date exists and send confirmation email to the customer.

The possible errors that can be raised are:

  • KT-CT-4923: Unauthorized.
  • KT-CT-4922: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

orderAnnulled (Boolean)

Whether the order annulment was successful.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "orderAnnulled": true
}

AnnulmentBillingDocumentType

An annulment is a billing document that annuls another billing document.

Fields

NameDescription

annulledBillingDocumentId (Int!)

ID of the billing document annulled by this annulment.

firstIssued (DateTime)

First time the annulment was issued.

id (Int!)

pdfUrl (String)

URL to the PDF of the annulment.

Example

{
  "id": 1,
  "annulledBillingDocumentId": 1,
  "firstIssued": "2020-01-01T00:00:00.000Z",
  "pdfUrl": "abc123"
}

AssistanceAgreementType

A single Assistance Agreement.

Fields

NameDescription

activeFrom (Date)

The start datetime of the agreement.

activeTo (Date)

The end datetime of the agreement, if any.

assistanceType (String)

The type of assistance provided by the agreement.

Example

{
  "assistanceType": "abc123",
  "activeFrom": "2020-01-01",
  "activeTo": "2020-01-01"
}

AuthFlow

A step where the user must complete an auth flow.

Fields

NameDescription

authorizationUri (String)

The URL to redirect the user to for authorization.

id (ID)

A unique identifier for this onboarding step.

redirectUri (String)

The URI where the auth flow is going to redirect back to at the end.

Example

{
  "id": "abc123",
  "redirectUri": "abc123",
  "authorizationUri": "abc123"
}

Fields

NameDescription

electricity (SupplyTypeSpecificSpinsType)

The remaining spins resulting from an electricity agreement.

gas (SupplyTypeSpecificSpinsType)

The remaining spins resulting from an gas agreement.


BackendScreenEvent

Returns an Action to perform, e.g. a screen to load.

BackendScreenEvents are specific types of Action which trigger a mutation in the Kraken backend. They return an action (any type), such as a ScreenActionType (which is then used to load the next screen). Any action registered in the registry should really be an "event" with some side-effect in the backend.

The possible errors that can be raised are:

  • KT-CT-1111: Unauthorized.
  • KT-CT-8002: No event found.
  • KT-CT-8003: Event has no execute function.
  • KT-CT-8004: Error executing event in the backend.
  • KT-CT-8007: Incorrect or missing parameters for backend screen event.
  • KT-GB-9310: Account ineligible for joining Octoplus.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

action (ActionType)

An action to perform.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "action": DeeplinkActionType
}

BackendScreenEventActionType

An action which triggers some event in the Kraken backend.

Fields

NameDescription

eventId (String!)

The ID of the event to trigger.

id (ID)

Unique identifier of the object.

params ([BackendScreenParam]!)

List of key-value pairs to pass as parameters to the event.

typeName (String)

The name of the action object's type.

typename (String)

The name of the object's type.

Example

{
  "typeName": "abc123",
  "id": "abc123",
  "typename": "abc123",
  "eventId": "abc123",
  "params": BackendScreenParam
}

BackendScreenParam

A key-value pair (both Strings) which is passed as a parameter to a screen.

Fields

NameDescription

key (String!)

value (String!)

Example

{
  "key": "abc123",
  "value": "abc123"
}

Fields

NameDescription

accountHolder (String)

Get the account holder name of the client's bank account.

bankName (String)

Get the name of the client's bank.

bic (String)

Get the BIC/SWIFT code for the client's bank account.

iban (String)

Get the IBAN of the client's bank account.

paymentReference (BankTransferReference)

Get the payment reference the customer should use to transfer monies.

Example

{
  "accountHolder": "abc123",
  "iban": "abc123",
  "bic": "abc123",
  "bankName": "abc123",
  "paymentReference": BankTransferReference
}

Fields

NameDescription

reference (String)

Get bank transfer payment reference for customer, based on the ledger they transfer monies for.

Example

{
  "reference": "abc123"
}

Fields

NameDescription

meterId (Int)

The meter id this reading belongs to.

origin (String)

readAt (DateTime!)

registerObisCode (String)

typeOfRead (String)

value (String!)

Example

{
  "value": "abc123",
  "readAt": "2020-01-01T00:00:00.000Z",
  "registerObisCode": "abc123",
  "typeOfRead": "abc123",
  "origin": "abc123",
  "meterId": 1
}

BillConnectionTypeConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([BillConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": BillConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

BillConnectionTypeEdge

A Relay edge containing a BillConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (BillInterface)

The item at the end of the edge

Example

{
  "node": BillInterface,
  "cursor": "abc123"
}

BillingAttachmentConnectionTypeConnection

A connection that can provide links to the attachments of the bill.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([BillingAttachmentConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": BillingAttachmentConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

BillingAttachmentConnectionTypeEdge

A Relay edge containing a BillingAttachmentConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (BillingAttachmentType)

The item at the end of the edge

Example

{
  "node": BillingAttachmentType,
  "cursor": "abc123"
}

BillingAttachmentType

Attachments are associated with a bill files and can be used to provide additional information to the customer.

Fields

NameDescription

filename (String)

The name of the file.

temporaryUrl (String)

The TemporaryURL type represents a temporary URL at which the file is available.It is intended for redirection purposes, NOT persistence in any form. (e.g. inclusion in emails or the body of a web page).

temporaryUrlExpiresAt (DateTime)

The expiry datetime field of the temporary URL.

Example

{
  "temporaryUrl": "abc123",
  "temporaryUrlExpiresAt": "2020-01-01T00:00:00.000Z",
  "filename": "abc123"
}

BillingOptionsType

Information about an account's billing schedule.

Fields

NameDescription

currentBillingPeriodEndDate (Date)

The date on which the current billing cycle will end. Null if the account is on flexible billing.

currentBillingPeriodStartDate (Date)

The date on which the current billing cycle started.

isFixed (Boolean!)

If true, this account is billed on specific day of a regular cycle. If false, the billing schedule is flexible, depending on when meter readings are submitted.

nextBillingDate (Date)

The next date on which this account will next be billed. This is the same as the start date for their next bill cycle. Null if the account is on flexible billing.

periodLength (AccountBillingOptionsPeriodLength)

periodLengthMultiplier (Int)

periodStartDay (Int)

The day of the month on which the account's billing period should start.

Example

{
  "periodStartDay": 1,
  "periodLength": "MONTHLY",
  "periodLengthMultiplier": 1,
  "isFixed": true,
  "currentBillingPeriodStartDate": "2020-01-01",
  "currentBillingPeriodEndDate": "2020-01-01",
  "nextBillingDate": "2020-01-01"
}

Fields

NameDescription

businessType (BusinessTypeOptions)

The company type of a business account.

linkedAccountNumber (ID!)

Account number linked to this business.

name (String!)

number (String!)

Example

{
  "name": "abc123",
  "number": "abc123",
  "businessType": "SOLE_TRADER",
  "linkedAccountNumber": "abc123"
}

CancelContract

Cancelling a contract for a given supply point and send confirmation email to the customer.

Fields

NameDescription

cancelledContract (Boolean)

Whether the contract cancellation was successful.

lastDayOfSupply (Date)

The last day of supply.

Example

{
  "cancelledContract": true,
  "lastDayOfSupply": "2020-01-01"
}

CancelRepaymentRequest

Cancel a repayment or refund request.

The possible errors that can be raised are:

  • KT-CT-4231: Unauthorized.
  • KT-CT-3930: The repayment or refund request does not exist.
  • KT-CT-3931: This repayment or refund request cannot be cancelled.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

repaymentRequest (CancelRepaymentRequestOutputType)

The cancelled repayment/refund request.

Example

{
  "possibleErrors": [PossibleErrorType],
  "repaymentRequest": CancelRepaymentRequestOutputType
}

CancelRepaymentRequestOutputType

Output from cancelling a repayment or refund request.

Fields

NameDescription

requestId (String)

The ID of the cancelled request.

status (RepaymentRequestStatus)

The current status of the cancelled request.

Example

{
  "requestId": "abc123",
  "status": "REQUESTED"
}

CancelSmartFlexOnboarding

Cancel onboarding of a device with SmartFlex.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

CardComponentType

A card containing a list of items

Fields

NameDescription

accessibilityHidden (Boolean)

Whether the element is hidden from view.

accessibilityLabel (String)

Accessible description of the element.

id (ID)

Unique identifier of the object.

items ([CardItemType]!)

The list of components.

typename (String)

The name of the object's type.

Example

{
  "accessibilityHidden": true,
  "accessibilityLabel": "abc123",
  "id": "abc123",
  "typename": "abc123",
  "items": TextType
}

Fields

NameDescription

cards ([CardComponentType]!)

The list of cards.

id (ID)

Unique identifier of the object.

typename (String)

The name of the object's type.

Example

{
  "id": "abc123",
  "typename": "abc123",
  "cards": CardComponentType
}

Charge

A charge to the customer.

Fields

NameDescription

accountNumber (String)

Unique identifier of the account the transaction belongs to.

amount (Int)

Gross amount including tax (when payable). Refer to the amounts field for a breakdown of this information.

Deprecated

The 'amount' field is deprecated.

Use `amounts` instead for a breakdown of the relevant net, tax, and gross amounts.

- Marked as deprecated on 2023-12-06.
- Will be removed on 2024-06-01.

amounts (TransactionAmountType)

The net, tax and gross amounts for the transaction. Note: for payments and repayments, only the net amount is returned.

balanceCarriedForward (Int)

The customer's resulting balance after this transaction has been applied, in the smallest unit of currency.

billingDocumentIdentifier (ID)

The unique identifier for the most recent billing document linked with the transaction.Note: a transaction may be linked with multiple documents, but this field will only return the identifier for the most recent billing document.

consumption (Consumption)

If this charge is for consumption of a good or service, this field will contain details of how much was consumed. Omitted in cases where the charge is not for consumption, or where consumption information is not available (e.g. for some older records).

createdAt (DateTime)

The date time when the transaction is created.

hasStatement (Boolean)

Returns True if the transaction is linked with a statement.

id (ID)

isAccountCharge (Boolean)

Deprecated.

Deprecated

The 'isAccountCharge' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isAccountPayment (Boolean)

Deprecated.

Deprecated

The 'isAccountPayment' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isCredit (Boolean)

Deprecated.

Deprecated

The 'isCredit' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isHeld (Boolean)

Whether the statement this transaction is on has been held. A held statement is not sent to a customer automatically, but is instead marked for manual attention by operations staff. Returns False if a statement is not linked with the transaction.

isIssued (Boolean)

Whether this transaction has been issued on any billing document.Note: Look for the most recently issued transaction instead of looking through all transactions as some accounts may have initial transactions that were not issued.This will return False if the transaction is not associated with any billing documents.

isReversed (Boolean!)

note (String)

Returns the note field value for the transaction, which contains additional info.

postedDate (Date)

statementId (ID)

Returns None if a statement is not linked with the transaction.

Deprecated

The 'statementId' field is deprecated.

Use `billingDocumentIdentifier` instead.

- Marked as deprecated on 2023-11-30.
- Will be removed on 2024-06-01.

title (String)

Example

{
  "id": "abc123",
  "postedDate": "2020-01-01",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "accountNumber": "abc123",
  "amount": 1,
  "amounts": TransactionAmountType,
  "balanceCarriedForward": 1,
  "isCredit": true,
  "isAccountCharge": true,
  "isAccountPayment": true,
  "isHeld": true,
  "isIssued": true,
  "title": "abc123",
  "billingDocumentIdentifier": "abc123",
  "statementId": "abc123",
  "isReversed": true,
  "hasStatement": true,
  "note": "abc123",
  "consumption": Consumption
}

Fields

NameDescription

make (String)

models ([ChargePointModelsType])

Example

{
  "make": "abc123",
  "models": [ChargePointModelsType]
}

Fields

NameDescription

model (String)

powerInKw ([String])

Example

{
  "model": "abc123",
  "powerInKw": ["abc123"]
}

Fields

NameDescription

amperage (Int)

Supply amperage. Used in markets where customers are more familiar with amps than power output.

integrationStatus (IntegrationStatus)

Shows the availability status of an integration.

isIntegrationLive (Boolean)

model (String)

powerInKw (Decimal)

variantId (Int)

Example

{
  "variantId": 1,
  "model": "abc123",
  "powerInKw": 1.0,
  "amperage": 1,
  "isIntegrationLive": true,
  "integrationStatus": "TESTING"
}

Fields

NameDescription

make (String)

models ([ChargePointVariantModelType])

Example

{
  "make": "abc123",
  "models": [ChargePointVariantModelType]
}

Fields

NameDescription

code (String)

The charge reason code.

display (String)

The charge reason display text.

group (String)

The group the charge reason belongs to (if applicable).

isDeprecated (Boolean)

Whether the charge reason is deprecated.

isHidden (Boolean)

Whether the charge reason is hidden.

isTaxExempt (Boolean)

Whether the charge reason is sales tax exempt.

Example

{
  "code": "abc123",
  "display": "abc123",
  "isDeprecated": true,
  "isTaxExempt": true,
  "isHidden": true,
  "group": "abc123"
}

CloseActionType

Closes the screen.

Fields

NameDescription

accessibilityHidden (Boolean)

Whether the element is hidden from view.

accessibilityLabel (String)

Accessible description of the element.

id (ID)

Unique identifier of the object.

typeName (String)

The name of the action object's type.

typename (String)

The name of the object's type.

Example

{
  "typeName": "abc123",
  "id": "abc123",
  "typename": "abc123",
  "accessibilityHidden": true,
  "accessibilityLabel": "abc123"
}

CollectPayment

The possible errors that can be raised are:

  • KT-CT-3932: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

payment (AccountPaymentType)

Details about the collected payment. Note that we might not be able to collect the payment (e.g. if there is no usable payment instruction), in which case the status of the returned payment might be failed or cancelled.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "payment": AccountPaymentType
}

Fields

NameDescription

attachments (BillingAttachmentConnectionTypeConnection)

billType (BillTypeEnum)

The type of the bill.

constituents (ConstituentConnection)

Constituents of the bill.

fromDate (Date)

The date of the bill is covered from.

id (ID)

The ID of the bill.

issuedDate (Date)

The date the bill was sent to the customer.

temporaryUrl (String)

Requesting this field generates a temporary URL at which bill is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page). This field can raise an error with errorClass NOT_FOUND if the bill document has not been created/issued yet. This field is deprecated use 'attachments' field instead.

Deprecated

The 'temporaryUrl' field is deprecated.

This field is deprecated. Use the 'attachments' field instead.

- Marked as deprecated on 2024-09-16.
- Will be removed on 2025-09-01.

toDate (Date)

The date of the bill is covered to.

Example

{
  "id": "abc123",
  "billType": "STATEMENT",
  "fromDate": "2020-01-01",
  "toDate": "2020-01-01",
  "temporaryUrl": "abc123",
  "issuedDate": "2020-01-01",
  "attachments": BillingAttachmentConnectionTypeConnection,
  "constituents": ConstituentConnection
}

Fields

NameDescription

fieldSpecificRateLimits (FieldSpecificRateLimitInformationConnectionTypeConnection!)

Information about the current state of the rate limiting for rate limited fields at the time of the request.

pointsAllowanceRateLimit (PointsAllowanceRateLimitInformation)

Information about points-allowance rate limit for viewer.

Example


CompleteAuthFlowForSmartFlexOnboarding

Complete the auth flow step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

CompleteTeslaSetupVirtualKeyForSmartFlexOnboarding

Complete the Tesla setup virtual key onboarding step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

ComponentListType

A list of components which comprise a screen.

This is a legacy type; GenericBackendScreen should be preferred. This is because API clients should not need to explicitly query for screen attributes like items - these fields are embedded in the screenData field.

Fields

NameDescription

accessibilityHidden (Boolean)

Whether the element is hidden from view.

accessibilityLabel (String)

Accessible description of the element.

id (ID)

Unique identifier of the object.

items ([ItemType]!)

The list of components.

Deprecated

The 'items' field is deprecated.

Access `items` via `screenData` instead.

- Marked as deprecated on 2024-07-02.
- Will be removed on 2024-08-01.

name (String!)

The name of the screen.

refreshFrequency (Int)

The refresh / polling frequency in milliseconds.

screenData (String)

Serialized JSON representation of the screen.

typename (String)

The name of the object's type.

Example

{
  "accessibilityHidden": true,
  "accessibilityLabel": "abc123",
  "id": "abc123",
  "typename": "abc123",
  "name": "abc123",
  "refreshFrequency": 1,
  "screenData": "abc123",
  "items": TextType
}

ConsentType

A consent given by a signing identity for a consent type.

Fields

NameDescription

code (String)

Unique code given to this consent type.

id (BigInt)

id of the consent.

value (ConsentValue)

Value of the consent.

Example

{
  "id": 1,
  "code": "abc123",
  "value": "ACCEPTED"
}

ConstituentConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([ConstituentEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": ConstituentEdge,
  "totalCount": 1,
  "edgeCount": 1
}

ConstituentEdge

A Relay edge containing a Constituent and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (ConstituentInterface)

The item at the end of the edge

Example

{
  "node": ConstituentInterface,
  "cursor": "abc123"
}

Fields

NameDescription

endDate (Date)

quantity (Decimal)

startDate (Date)

supplyCharge (Int)

unit (ConsumptionUnit)

usageCost (Int)

Example

{
  "startDate": "2020-01-01",
  "endDate": "2020-01-01",
  "quantity": 1.0,
  "unit": "kWh",
  "usageCost": 1,
  "supplyCharge": 1
}

ContributionAgreementType

A single Contribution Agreement.

Fields

NameDescription

activeFrom (DateTime)

The start datetime of the agreement.

activeTo (DateTime)

The end datetime of the agreement, if any.

amount (Int)

The amount contributed per interval. Note, this is in the smallest domination that the currecy support. e.g. Pence, Cents, Yen, etc.

contributionScheme (ContributionSchemeType)

The scheme to which the agreement contributes.

id (ID!)

interval (Interval)

The frequency of contributions.

periods (ContributionPeriodConnection)

The periods over which contributions have been made.

Example

{
  "id": "abc123",
  "contributionScheme": ContributionSchemeType,
  "interval": "MONTHLY",
  "activeFrom": "2020-01-01T00:00:00.000Z",
  "activeTo": "2020-01-01T00:00:00.000Z",
  "amount": 1,
  "periods": ContributionPeriodConnection
}

ContributionPeriodConnection

Pagination for contribution periods.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([ContributionPeriodEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": ContributionPeriodEdge,
  "totalCount": 1,
  "edgeCount": 1
}

ContributionPeriodEdge

A Relay edge containing a ContributionPeriod and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (ContributionPeriodType)

The item at the end of the edge

Example

{
  "node": ContributionPeriodType,
  "cursor": "abc123"
}

ContributionPeriodType

A single Contribution Period.

Fields

NameDescription

agreement (ContributionAgreementType!)

fulfilledAt (DateTime)

When the contribution was fulfilled

id (ID!)

periodFrom (DateTime)

The datetime the marks the beginning of the period.

periodTo (DateTime)

The datetime the marks the end of the period.

Example

{
  "id": "abc123",
  "agreement": ContributionAgreementType,
  "fulfilledAt": "2020-01-01T00:00:00.000Z",
  "periodFrom": "2020-01-01T00:00:00.000Z",
  "periodTo": "2020-01-01T00:00:00.000Z"
}

ContributionSchemeType

A single Contribution Scheme.

Fields

NameDescription

acceptingContributions (Boolean!)

Is this scheme currently accepting contributions?

code (String!)

displayName (String!)

id (ID!)

taxable (Boolean!)

Are contributions to this scheme taxable?

Example

{
  "id": "abc123",
  "code": "abc123",
  "displayName": "abc123",
  "taxable": true,
  "acceptingContributions": true
}

Fields

NameDescription

latitude (Float)

longitude (Float)

Example

{
  "latitude": 1.0,
  "longitude": 1.0
}

Fields

NameDescription

costOfChargeId (String)

isSmartCharge (Boolean)

krakenflexDeviceId (String)

reportDate (Date)

totalConsumption (Float)

Consumption in kWh.

totalCostExclTax (Float)

Cost in pence (excl. tax).

totalCostInclTax (Float)

Cost in pence (incl. tax).

Example

{
  "costOfChargeId": "abc123",
  "krakenflexDeviceId": "abc123",
  "reportDate": "2020-01-01",
  "isSmartCharge": true,
  "totalConsumption": 1.0,
  "totalCostExclTax": 1.0,
  "totalCostInclTax": 1.0
}

CreateAccountPaymentSchedule

The possible errors that can be raised are:

  • KT-CT-1111: Unauthorized.
  • KT-CT-3815: No active payment schedule found for this account.
  • KT-CT-3822: Unauthorized.
  • KT-CT-3923: Unauthorized.
  • KT-CT-3941: Invalid data.
  • KT-CT-3942: An unexpected error occurred.
  • KT-CT-3947: An unexpected error occurred.
  • KT-CT-3960: Invalid value for payment day.
  • KT-CT-3961: Cannot update plan-associated payment schedule.
  • KT-CT-3962: No new value provided to update payment schedule.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

schedule (PaymentScheduleType!)

New payment schedule.

Example

{
  "possibleErrors": [PossibleErrorType],
  "schedule": PaymentScheduleType
}

CreateAccountReference

Create an account reference.

The possible errors that can be raised are:

  • KT-CT-4123: Unauthorized.
  • KT-CT-8310: Invalid data.
  • KT-CT-8311: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

accountReference (AccountReferenceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "accountReference": AccountReferenceType
}

CreateContributionAgreement

The possible errors that can be raised are:

  • KT-CT-4123: Unauthorized.
  • KT-CT-9601: Invalid data.
  • KT-CT-9602: Unable to create contribution agreement.
  • KT-CT-9605: Contribution amount cannot be 0 or negative.
  • KT-CT-9606: Scheme is not accepting contributions at this time.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

contributionAgreement (ContributionAgreementType)

The created contribution agreement.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "contributionAgreement": ContributionAgreementType
}

CreateDirectDebitInstruction

The possible errors that can be raised are:

  • KT-DE-3914: Invalid data.
  • KT-DE-3910: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

directDebitInstruction (PaymentInstructionType)

The payment instruction.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "directDebitInstruction": PaymentInstructionType
}

CreateElectricityMeterReadings

The possible errors that can be raised are:

  • KT-DE-6414: Invalid data.
  • KT-DE-6411: Meter has no MaLo.
  • KT-DE-6412: Meter reading submission failed.
  • KT-DE-6413: An internal error occurred.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

numberOfReadingsCreated (Int)

possibleErrors ([PossibleErrorType])

readingDate (Date)

Example

{
  "possibleErrors": [PossibleErrorType],
  "readingDate": "2020-01-01",
  "numberOfReadingsCreated": 1
}

CreateGasMeterReadings

The possible errors that can be raised are:

  • KT-DE-6414: Invalid data.
  • KT-DE-6411: Meter has no MaLo.
  • KT-DE-6412: Meter reading submission failed.
  • KT-DE-6413: An internal error occurred.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

numberOfReadingsCreated (Int)

possibleErrors ([PossibleErrorType])

readingDate (Date)

Example

{
  "possibleErrors": [PossibleErrorType],
  "readingDate": "2020-01-01",
  "numberOfReadingsCreated": 1
}

CreateGoodsPurchase

The possible errors that can be raised are:

  • KT-CT-8206: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

goodsPurchase (GoodsPurchase)

Goods purchase created.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "goodsPurchase": GoodsPurchase
}

CreateGoodsQuote

The possible errors that can be raised are:

  • KT-CT-8202: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

goodsQuote (GoodsQuote)

Goods quote created for the customer.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "goodsQuote": GoodsQuote
}

CreateGoodsQuoteWithoutAccount

The possible errors that can be raised are:

  • KT-CT-8202: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

goodsQuote (GoodsQuote)

Goods quote created for the customer.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "goodsQuote": GoodsQuote
}

Fields

NameDescription

content (String)

id (String)

Example

{
  "content": "abc123",
  "id": "abc123"
}

Fields

NameDescription

code (String)

Code of the quote request that was generated.

electricityQuote (ElectricityQuote)

Details of the electricity quote.

gasQuote (GasQuote)

Details of the gas quote.

Example

{
  "code": "abc123",
  "electricityQuote": ElectricityQuote,
  "gasQuote": GasQuote
}

CreateReferral

Use a referral code to create a referral and trigger a referral reward.

The possible errors that can be raised are:

  • KT-CT-6723: Unauthorized.
  • KT-CT-6710: Unable to create referral.
  • KT-CT-6711: Accounts may not self-refer.
  • KT-CT-6713: Referring and referred account brands do not match.
  • KT-CT-6712: Invalid reference.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

referredAccountRewardAmount (Int)

The reward amount to be issued to the referred account, in smallest currency subunits.

Example

{
  "possibleErrors": [PossibleErrorType],
  "referredAccountRewardAmount": 1
}

Credit

A credit to the customer from the energy retailer.

Fields

NameDescription

accountNumber (String)

Unique identifier of the account the transaction belongs to.

amount (Int)

Gross amount including tax (when payable). Refer to the amounts field for a breakdown of this information.

Deprecated

The 'amount' field is deprecated.

Use `amounts` instead for a breakdown of the relevant net, tax, and gross amounts.

- Marked as deprecated on 2023-12-06.
- Will be removed on 2024-06-01.

amounts (TransactionAmountType)

The net, tax and gross amounts for the transaction. Note: for payments and repayments, only the net amount is returned.

balanceCarriedForward (Int)

The customer's resulting balance after this transaction has been applied, in the smallest unit of currency.

billingDocumentIdentifier (ID)

The unique identifier for the most recent billing document linked with the transaction.Note: a transaction may be linked with multiple documents, but this field will only return the identifier for the most recent billing document.

createdAt (DateTime)

The date time when the transaction is created.

hasStatement (Boolean)

Returns True if the transaction is linked with a statement.

id (ID)

isAccountCharge (Boolean)

Deprecated.

Deprecated

The 'isAccountCharge' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isAccountPayment (Boolean)

Deprecated.

Deprecated

The 'isAccountPayment' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isCredit (Boolean)

Deprecated.

Deprecated

The 'isCredit' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isHeld (Boolean)

Whether the statement this transaction is on has been held. A held statement is not sent to a customer automatically, but is instead marked for manual attention by operations staff. Returns False if a statement is not linked with the transaction.

isIssued (Boolean)

Whether this transaction has been issued on any billing document.Note: Look for the most recently issued transaction instead of looking through all transactions as some accounts may have initial transactions that were not issued.This will return False if the transaction is not associated with any billing documents.

isReversed (Boolean!)

note (String)

Returns the note field value for the transaction, which contains additional info.

postedDate (Date)

statementId (ID)

Returns None if a statement is not linked with the transaction.

Deprecated

The 'statementId' field is deprecated.

Use `billingDocumentIdentifier` instead.

- Marked as deprecated on 2023-11-30.
- Will be removed on 2024-06-01.

title (String)

Example

{
  "id": "abc123",
  "postedDate": "2020-01-01",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "accountNumber": "abc123",
  "amount": 1,
  "amounts": TransactionAmountType,
  "balanceCarriedForward": 1,
  "isCredit": true,
  "isAccountCharge": true,
  "isAccountPayment": true,
  "isHeld": true,
  "isIssued": true,
  "title": "abc123",
  "billingDocumentIdentifier": "abc123",
  "statementId": "abc123",
  "isReversed": true,
  "hasStatement": true,
  "note": "abc123"
}

Fields

NameDescription

code (String)

The credit reason code.

display (String)

The credit reason display text.

group (String)

The group the credit reason belongs to (if applicable).

isDeprecated (Boolean)

Whether the credit reason is deprecated.

isHidden (Boolean)

Whether the credit reason is hidden.

isTaxExempt (Boolean)

Whether the credit reason is sales tax exempt.

Example

{
  "code": "abc123",
  "display": "abc123",
  "isDeprecated": true,
  "isTaxExempt": true,
  "isHidden": true,
  "group": "abc123"
}

Fields

NameDescription

id (ID!)

rawScore (Int)

The value attached to the source

submittedAt (DateTime)

The datetime the feedback was submitted

Example

{
  "id": "abc123",
  "rawScore": 1,
  "submittedAt": "2020-01-01T00:00:00.000Z"
}

Dashboard

A list of components which comprise a dashboard screen.

Fields

NameDescription

dashboardItems ([SectionType]!)

The list of sections for a dashboard.

id (ID)

Unique identifier of the object.

serialisedDashboardItems (String!)

The serialised dashboard items.

typename (String)

The name of the object's type.

Example

{
  "id": "abc123",
  "typename": "abc123",
  "dashboardItems": SectionType,
  "serialisedDashboardItems": "abc123"
}

DeauthenticateDevice

De-authenticate a registered device.

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4350: Unable to de-authenticate device.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (DeviceDetailsType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": DeviceDetailsType
}

DeeplinkActionType

An action which navigates to the URL of another backend screen.

Fields

NameDescription

id (ID)

Unique identifier of the object.

typeName (String)

The name of the action object's type.

typename (String)

The name of the object's type.

url (String!)

The URL to navigate to.

Example

{
  "typeName": "abc123",
  "id": "abc123",
  "typename": "abc123",
  "url": "abc123"
}

DeleteBoostCharge

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4354: Unable to cancel boost charge.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

DeletePushNotificationBinding

The possible errors that can be raised are:

  • KT-CT-5411: Invalid token or no push notification binding found for the given account user.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

status (DeletePushNotificationBindingOutput)

Example

{
  "possibleErrors": [PossibleErrorType],
  "status": "SUCCESSFUL"
}

Fields

NameDescription

deviceType (KrakenFlexDeviceTypes)

The type of device.

krakenflexDeviceId (String)

provider (ProviderChoices)

The third party that provides control over this device.

Example

{
  "krakenflexDeviceId": "abc123",
  "provider": "DAIKIN",
  "deviceType": "BATTERIES"
}

DeviceRegistration

Register a device for smart controlling.

Where device refers to batteries, electric vehicles, heat pumps or thermostats.

The possible errors that can be raised are:

  • KT-CT-4324: Device already registered error.
  • KT-CT-4321: Serializer validation error.
  • KT-CT-4312: Unable to register device.
  • KT-CT-4363: No capable devices found.
  • KT-CT-4364: Multiple devices found.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

registeredDeviceIds ([String])

Device ID(s) of the registered device(s).

Example

{
  "possibleErrors": [PossibleErrorType],
  "registeredDeviceIds": ["abc123"]
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([DirectDebitInstructionConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": DirectDebitInstructionConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

DirectDebitInstructionConnectionTypeEdge

A Relay edge containing a DirectDebitInstructionConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (DirectDebitInstructionType)

The item at the end of the edge

Example

{
  "node": DirectDebitInstructionType,
  "cursor": "abc123"
}

DirectDebitInstructionType

Direct Debit Instructions

Fields

NameDescription

accountHolder (String!)

cardExpiryMonth (Int)

cardExpiryYear (Int)

cardPaymentNetwork (String)

iban (String!)

id (ID!)

instructionType (String!)

lastFourDigitsOfAccountNumber (String)

The last four digits of the account number.

Deprecated

The 'lastFourDigitsOfAccountNumber' field is deprecated.

Use 'maskedAccountIdentifier' for a masked reference to the instruction.

- Marked as deprecated on 2021-12-23.
- Will be removed on 2024-01-01.

maskedAccountIdentifier (String)

A masked reference to a recurring payment method.

maskedIban (String)

A masked version of the IBAN.

sortCode (String!)

status (String!)

Example

{
  "id": "abc123",
  "status": "abc123",
  "sortCode": "abc123",
  "iban": "abc123",
  "accountHolder": "abc123",
  "instructionType": "abc123",
  "cardPaymentNetwork": "abc123",
  "cardExpiryMonth": 1,
  "cardExpiryYear": 1,
  "lastFourDigitsOfAccountNumber": "abc123",
  "maskedAccountIdentifier": "abc123",
  "maskedIban": "abc123"
}

Fields

NameDescription

discount (Decimal!)

The discount as a decimal between 0 and 1.

metaData (FanClubMetadataOutput)

This type will return additional market specific information. For example, some markets support wind direction, fan speed, wind speed, etc. while others do not.

startAt (DateTime!)

Timestamp for the discount.

Example

{
  "startAt": "2020-01-01T00:00:00.000Z",
  "discount": 1.0,
  "metaData": FanClubMetadataOutput
}

Fields

NameDescription

baseTime (DateTime!)

The start time that the ensemble forecast simulation.

data ([ForecastData]!)

Discount forecast data-points.

Example

{
  "baseTime": "2020-01-01T00:00:00.000Z",
  "data": ForecastData
}

Fields

NameDescription

availableFrom (Int)

This field is replacing year.

availableTo (Int)

batterySize (Decimal)

integrationStatus (IntegrationStatus)

Shows the availability status of an integration.

isIntegrationLive (Boolean)

model (String)

supportedProviders ([String])

vehicleId (Int)

year (Int)

Example

{
  "vehicleId": 1,
  "model": "abc123",
  "year": 1,
  "availableFrom": 1,
  "availableTo": 1,
  "batterySize": 1.0,
  "supportedProviders": ["abc123"],
  "isIntegrationLive": true,
  "integrationStatus": "TESTING"
}

Fields

NameDescription

make (String)

models ([ElectricVehicleModelType])

Example

{
  "make": "abc123",
  "models": [ElectricVehicleModelType]
}

Fields

NameDescription

deviceId (String)

marketSupplyPointId (String)

readingDirection (ReadingDirectionType)

Reading direction is based on the utility generated or consumed by the customer.

readingFrequencyType (ReadingFrequencyType)

readingQuality (ReadingQualityType)

registerId (String)

Example

{
  "readingDirection": "CONSUMPTION",
  "registerId": "abc123",
  "readingQuality": "ACTUAL",
  "readingFrequencyType": "RAW_INTERVAL",
  "marketSupplyPointId": "abc123",
  "deviceId": "abc123"
}

ElectricityMeterConnectionTypeConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([ElectricityMeterConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": ElectricityMeterConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

ElectricityMeterConnectionTypeEdge

A Relay edge containing a ElectricityMeterConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (ElectricityMeterType)

The item at the end of the edge

Example

{
  "node": ElectricityMeterType,
  "cursor": "abc123"
}

Fields

NameDescription

registers ([ElectricityRegisterForReadingType])

All registers relevant for billing for the meter.

Example


ElectricityMeterReadingConnectionTypeConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([ElectricityMeterReadingConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": ElectricityMeterReadingConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

ElectricityMeterReadingConnectionTypeEdge

A Relay edge containing a ElectricityMeterReadingConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (ElectricityRegisterReadingType)

The item at the end of the edge

Example

{
  "node": ElectricityRegisterReadingType,
  "cursor": "abc123"
}

Fields

NameDescription

activeFrom (DateTime!)

The datetime when the meter was active from.

activeTo (DateTime)

The datetime when the meter stops being active. This should be null if it is still active.

conversionFactor (String)

The conversion factor/Wandlerfaktor of the meter.

id (Int!)

The meter ID.

meloNumber (String)

The MeLo number associated with the meter.

meteringDirection (String)

The metering direction of the meter.

number (String!)

The meter number.

readingTransmissionType (String)

The reading transmission type of the meter.

tariffCount (String)

The tariff count of the meter.

Example

{
  "id": 1,
  "number": "abc123",
  "activeFrom": "2020-01-01T00:00:00.000Z",
  "activeTo": "2020-01-01T00:00:00.000Z",
  "meteringDirection": "abc123",
  "readingTransmissionType": "abc123",
  "tariffCount": "abc123",
  "meloNumber": "abc123",
  "conversionFactor": "abc123"
}

Fields

NameDescription

breakdownChargeAnnual (Decimal)

eegChargeAnnual (Decimal)

gridBillingChargeAnnual (Decimal)

gridConcessionChargeAnnual (Decimal)

gridConcessionChargeAnnualNt (Decimal)

gridMeterOperationChargeAnnual (Decimal)

gridMeterReadingChargeAnnual (Decimal)

gridStandingChargeAnnual (Decimal)

gridUnitRateHtChargeAnnual (Decimal)

gridUnitRateNtChargeAnnual (Decimal)

kwkChargeAnnual (Decimal)

offshoreChargeAnnual (Decimal)

section19ChargeAnnual (Decimal)

totalNetworkChargesPerYear (Decimal)

Example

{
  "kwkChargeAnnual": 1.0,
  "breakdownChargeAnnual": 1.0,
  "eegChargeAnnual": 1.0,
  "gridBillingChargeAnnual": 1.0,
  "gridMeterOperationChargeAnnual": 1.0,
  "gridMeterReadingChargeAnnual": 1.0,
  "totalNetworkChargesPerYear": 1.0,
  "gridStandingChargeAnnual": 1.0,
  "gridConcessionChargeAnnual": 1.0,
  "gridConcessionChargeAnnualNt": 1.0,
  "offshoreChargeAnnual": 1.0,
  "section19ChargeAnnual": 1.0,
  "gridUnitRateHtChargeAnnual": 1.0,
  "gridUnitRateNtChargeAnnual": 1.0
}

Fields

NameDescription

affiliateSessionId (String)

The session id of the affiliate.

annualConsumption (Int)

annualNighttimeConsumption (Int)

energyType (String)

generatedOn (Date)

monthlyStandingCharge (Decimal)

netMonthlyStandingCharge (Decimal)

The net monthly standing charge in €.

networkCharges (ElectricityNetworkCharges)

networkOperatorNumber (String)

nighttimeUnitRatePerKwh (Decimal)

productCode (String)

The code of the Electricity product.

productIsTimeOfUse (Boolean)

Whether the product is a time-of-use product.

totalEstimatedAnnualBill (Decimal)

unitRateInformation (UnitRateInformation!)

The unit rate information.

unitRatePerKwh (Decimal)

The unit rate per kWh in €.

Deprecated

The 'unitRatePerKwh' field is deprecated.

Use unit_rate_information instead.

- Marked as deprecated on 2023-12-11.
- Will be removed on 2024-06-01.

Example

{
  "totalEstimatedAnnualBill": 1.0,
  "monthlyStandingCharge": 1.0,
  "unitRatePerKwh": 1.0,
  "nighttimeUnitRatePerKwh": 1.0,
  "annualConsumption": 1,
  "annualNighttimeConsumption": 1,
  "energyType": "abc123",
  "affiliateSessionId": "abc123",
  "networkOperatorNumber": "abc123",
  "generatedOn": "2020-01-01",
  "networkCharges": ElectricityNetworkCharges,
  "productCode": "abc123",
  "netMonthlyStandingCharge": 1.0,
  "productIsTimeOfUse": true,
  "unitRateInformation": SimpleProductUnitRateInformation
}

Fields

NameDescription

activeFrom (Date)

The date from when the register is active.

activeTo (Date)

The date until when the register is active.

decimalPlaces (Int)

The number of decimal places on the register.

digits (Int)

The number of digits on the register.

obisCode (String)

The OBIS code of the register.

readings (RegisterReadingConnectionTypeConnection)

The readings for a given register, in reverse order (latest first).

This field is a connection type. Connections are used to implement cursor based pagination.

This field requires the Authorization header to be set.

registerType (String)

Example

{
  "obisCode": "abc123",
  "digits": 1,
  "decimalPlaces": 1,
  "activeFrom": "2020-01-01",
  "activeTo": "2020-01-01",
  "readings": RegisterReadingConnectionTypeConnection,
  "registerType": "abc123"
}

Fields

NameDescription

meterId (Int)

The meter id this reading belongs to.

origin (String)

readAt (DateTime!)

registerObisCode (String)

registerType (String)

typeOfRead (String)

value (String!)

Example

{
  "value": "abc123",
  "readAt": "2020-01-01T00:00:00.000Z",
  "registerObisCode": "abc123",
  "typeOfRead": "abc123",
  "origin": "abc123",
  "meterId": 1,
  "registerType": "abc123"
}

EmailAttachmentType

Represents a file to attach to a email message.

Fields

NameDescription

filename (String!)

id (ID!)

temporaryUrl (String)

Temporary URL at which the attachment is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page).

Example

{
  "id": "abc123",
  "filename": "abc123",
  "temporaryUrl": "abc123"
}

Fields

NameDescription

eventType (String!)

id (ID!)

The ID of the object

message (EmailType)

Email message of the email event. Returns null for message's sent/received by other user's on the account.

occurredAt (DateTime!)

Example

{
  "id": "abc123",
  "eventType": "abc123",
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "message": EmailType
}

EmailType

Represents an email communication

Fields

NameDescription

attachments ([EmailAttachmentType])

Attachments of the email message.

channel (MessageChannel!)

createdAt (DateTime!)

fromEmail (String!)

fromNumber (String!)

htmlBody (String)

id (ID!)

recipient (String)

Email recipient.

sender (String)

Email sender.

sentAt (DateTime)

subject (String)

Subject line of the email message.

templateCode (String!)

textBody (String)

toAddress (String!)

toNumber (String!)

Example

{
  "id": "abc123",
  "channel": "EMAIL",
  "toAddress": "abc123",
  "fromEmail": "abc123",
  "toNumber": "abc123",
  "fromNumber": "abc123",
  "templateCode": "abc123",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "sentAt": "2020-01-01T00:00:00.000Z",
  "attachments": [EmailAttachmentType],
  "subject": "abc123",
  "textBody": "abc123",
  "htmlBody": "abc123",
  "sender": "abc123",
  "recipient": "abc123"
}

Fields

NameDescription

deviceId (String)

marketSupplyPointId (String)

readingDirection (ReadingDirectionType)

Reading direction is based on the utility generated or consumed by the customer.

readingFrequencyType (ReadingFrequencyType)

readingQuality (ReadingQualityType)

registerId (String)

Example

{
  "readingDirection": "CONSUMPTION",
  "registerId": "abc123",
  "readingQuality": "ACTUAL",
  "readingFrequencyType": "RAW_INTERVAL",
  "marketSupplyPointId": "abc123",
  "deviceId": "abc123"
}

EmbeddedNetworkType

Represents an embedded network that holds multiple embedded properties.

Fields

NameDescription

embeddedProperties ([EmbeddedPropertyType])

Get details about properties in an embedded network.

id (ID!)

name (String!)

A unique name/code for the network

Example

{
  "id": "abc123",
  "name": "abc123",
  "embeddedProperties": [EmbeddedPropertyType]
}

EndContributionAgreement

The possible errors that can be raised are:

  • KT-CT-9603: Unable to find contribution agreement.
  • KT-CT-4123: Unauthorized.
  • KT-CT-9604: Unable to end contribution agreement.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

contributionAgreement (ContributionAgreementType)

The created contribution agreement.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "contributionAgreement": ContributionAgreementType
}

EnergyMixDataType

Energy mix data can include the latest carbon intensity index in a region.

Fields

NameDescription

carbonIntensityIndex (String)

Current carbon intensity index.

Example

{
  "carbonIntensityIndex": "abc123"
}

Fields

NameDescription

linkState (String)

linkUrl (String)

Example

{
  "linkState": "abc123",
  "linkUrl": "abc123"
}

Fields

NameDescription

field (String!)

messages ([String!]!)

Example

{
  "field": "abc123",
  "messages": "abc123"
}

Fields

NameDescription

costCurrency (String!)

Monetary currency of the statistic in ISO-4217 format.

estimatedAmount (Decimal!)

        Monetary cost of the statistic. This is the smallest unit of currency,
        e.g. cents for USD or yen for JPY. Because electricity is priced as a commodity, we must
        account for fractional cents and this field must be a Decimal. Values from this field should
        likely not be used for accounting purposes.

pricePerUnit (PricePerUnit)

Net price per unit of the statistic if applicable.

Example

{
  "estimatedAmount": 1.0,
  "costCurrency": "abc123",
  "pricePerUnit": PricePerUnit
}

Fields

NameDescription

power (Decimal)

The instantaneous turbine output power in kW.

rotorSpeed (Decimal)

The turbine's rotor speed in revolutions per minute.

totalPowerOnGrid (Decimal)

The total amount of electricity grid-wide from all sources in megawatts.

windDirection (Decimal)

A decimal in degrees representing the direction from which the wind is blowing. 360.0 degrees indicates the wind blows from the north. Read more here: https://confluence.ecmwf.int/pages/viewpage.action?pageId=133262398

windPowerOnGrid (Decimal)

The total amount of electricity grid-wide from wind in megawatts.

windPowerProportion (Decimal)

The proportion of electricity on the grid coming from wind. Ranges from 0.0 - 1.0.

windSpeed (Decimal)

The wind speed in m/s.

Example

{
  "power": 1.0,
  "windSpeed": 1.0,
  "windDirection": 1.0,
  "rotorSpeed": 1.0,
  "windPowerOnGrid": 1.0,
  "totalPowerOnGrid": 1.0,
  "windPowerProportion": 1.0
}

Fields

NameDescription

accountNumbers ([String]!)

The list of account numbers for the source and account user.

catchments ([String]!)

The list of catchments that this discount source applies to.

current (DiscountData!)

The current or 'live' status of discounts for this source.

discountSource (String!)

The source for the discount, e.g. 'Fan 1' for a wind turbine in UK, or an ERCOT Load Zone for US.

forecast (DiscountForecast)

The forecasted discount probabilities for this source.

historic ([DiscountData]!)

The historic discounts for this source.

location (String)

The location of the discount source.

name (String!)

The name of the discount source.

propertyIds ([Int]!)

The list of property IDs for the source and account user.

thresholds ([Threshold]!)

The details of Fan Club thresholds for the discount source.

windFarm (String)

The wind farm that the discount source is part of.

Example

{
  "discountSource": "abc123",
  "name": "abc123",
  "location": "abc123",
  "windFarm": "abc123",
  "accountNumbers": "abc123",
  "propertyIds": 1,
  "catchments": "abc123",
  "thresholds": Threshold,
  "current": DiscountData,
  "historic": DiscountData,
  "forecast": DiscountForecast
}

Fields

NameDescription

field (String)

The name of the GraphQL field for which the rate is limited.

isBlocked (Boolean)

Whether the viewer is currently blocked from making requests to this field due to exceeding the allowed request rate.

rate (String)

Indicates the rate limit allowed for this field (e.g. 10/m).

ttl (Int)

Time to live: The time remaining before the user is unblocked from making requests to this field.

Example

{
  "field": "abc123",
  "rate": "abc123",
  "ttl": 1,
  "isBlocked": true
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([FieldSpecificRateLimitInformationConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": FieldSpecificRateLimitInformationConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

FieldSpecificRateLimitInformationConnectionTypeEdge

A Relay edge containing a FieldSpecificRateLimitInformationConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (FieldSpecificRateLimitInformation)

The item at the end of the edge

Example

{
  "node": FieldSpecificRateLimitInformation,
  "cursor": "abc123"
}

Fields

NameDescription

effectiveAt (DateTime!)

The time at which forced reauthentication is effective. Kraken and refresh tokens issued before this time will be invalid.

tokensInvalidated (Boolean!)

Reports whether the mutation applied successfully. Should always be 'true'.

Example

{
  "tokensInvalidated": true,
  "effectiveAt": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

powerLowerBound (Decimal!)

Lower confidence interval bound for forecasted power (kW).

powerMedian (Decimal!)

The best guess for forecasted power (kW).

powerUpperBound (Decimal!)

Upper confidence interval bound for forecasted power (kW).

projectedDiscount (Decimal!)

Projected discount based on ensemble forecast data.

validTime (DateTime!)

Timestamp for the data-point.

Example

{
  "validTime": "2020-01-01T00:00:00.000Z",
  "projectedDiscount": 1.0,
  "powerMedian": 1.0,
  "powerLowerBound": 1.0,
  "powerUpperBound": 1.0
}

Fields

NameDescription

content (JSONString)

errors ([SerializerFieldErrorsType])

id (Int)

Example

{
  "id": 1,
  "content": {"key": "value"},
  "errors": [SerializerFieldErrorsType]
}

FractionSizeType

A fractional measurement.

Fields

NameDescription

fraction (Decimal!)

The fractional value.

id (ID)

Unique identifier of the object.

typename (String)

The name of the object's type.

Example

{
  "id": "abc123",
  "typename": "abc123",
  "fraction": 1.0
}

GasFiltersOutput

Filter measurements by gas parameters.

Fields

NameDescription

deviceId (String)

marketSupplyPointId (String)

readingFrequencyType (ReadingFrequencyType)

registerId (String)

Example

{
  "registerId": "abc123",
  "readingFrequencyType": "RAW_INTERVAL",
  "marketSupplyPointId": "abc123",
  "deviceId": "abc123"
}

GasMeterConnectionTypeConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([GasMeterConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": GasMeterConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

GasMeterConnectionTypeEdge

A Relay edge containing a GasMeterConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (GasMeterType)

The item at the end of the edge

Example

{
  "node": GasMeterType,
  "cursor": "abc123"
}

Fields

NameDescription

registers ([GasRegisterForReadingType])

All registers relevant for billing for the meter.

Example

{
  "registers": [GasRegisterForReadingType]
}

GasMeterReadingConnectionTypeConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([GasMeterReadingConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": GasMeterReadingConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

GasMeterReadingConnectionTypeEdge

A Relay edge containing a GasMeterReadingConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (GasRegisterReadingType)

The item at the end of the edge

Example

{
  "node": GasRegisterReadingType,
  "cursor": "abc123"
}

Fields

NameDescription

activeFrom (DateTime!)

The datetime when the meter was active from.

activeTo (DateTime)

The datetime when the meter stops being active. This should be null if it is still active.

id (Int!)

The meter ID.

meloNumber (String)

The MeLo number associated with the meter.

meteringDirection (String)

The metering direction of the meter.

number (String!)

The meter number.

readingTransmissionType (String)

The reading transmission type of the meter.

tariffCount (String)

The tariff count of the meter.

Example

{
  "id": 1,
  "number": "abc123",
  "activeFrom": "2020-01-01T00:00:00.000Z",
  "activeTo": "2020-01-01T00:00:00.000Z",
  "meteringDirection": "abc123",
  "readingTransmissionType": "abc123",
  "tariffCount": "abc123",
  "meloNumber": "abc123"
}

Fields

NameDescription

accountingFee (Decimal)

gridBillingChargeAnnual (Decimal)

gridConcessionChargePerKwh (Decimal)

gridMeterOperationChargeAnnual (Decimal)

gridMeterReadingChargeAnnual (Decimal)

gridPowerChargeAnnual (Decimal)

gridStandingChargeAnnual (Decimal)

gridUnitRateChargeAnnual (Decimal)

totalNetworkChargesPerYear (Decimal)

Example

{
  "totalNetworkChargesPerYear": 1.0,
  "gridStandingChargeAnnual": 1.0,
  "gridConcessionChargePerKwh": 1.0,
  "gridPowerChargeAnnual": 1.0,
  "gridUnitRateChargeAnnual": 1.0,
  "gridBillingChargeAnnual": 1.0,
  "gridMeterOperationChargeAnnual": 1.0,
  "gridMeterReadingChargeAnnual": 1.0,
  "accountingFee": 1.0
}

Fields

NameDescription

affiliateSessionId (String)

The session id of the affiliate.

annualConsumption (Int)

energyType (String)

generatedOn (Date)

monthlyStandingCharge (Decimal)

netMonthlyStandingCharge (Decimal)

The net monthly standing charge in €.

networkCharges (GasNetworkCharges)

networkOperatorNumber (String)

productCode (String)

The code of the Gas product.

productIsTimeOfUse (Boolean)

Whether the product is a time-of-use product.

totalEstimatedAnnualBill (Decimal)

unitRateInformation (UnitRateInformation!)

The unit rate information.

unitRatePerKwh (Decimal)

The unit rate per kWh in €.

Deprecated

The 'unitRatePerKwh' field is deprecated.

Use unit_rate_information instead.

- Marked as deprecated on 2023-12-11.
- Will be removed on 2024-06-01.

Example

{
  "affiliateSessionId": "abc123",
  "totalEstimatedAnnualBill": 1.0,
  "monthlyStandingCharge": 1.0,
  "unitRatePerKwh": 1.0,
  "annualConsumption": 1,
  "networkCharges": GasNetworkCharges,
  "energyType": "abc123",
  "networkOperatorNumber": "abc123",
  "generatedOn": "2020-01-01",
  "productCode": "abc123",
  "netMonthlyStandingCharge": 1.0,
  "productIsTimeOfUse": true,
  "unitRateInformation": SimpleProductUnitRateInformation
}

Fields

NameDescription

activeFrom (Date)

The date from when the register is active.

activeTo (Date)

The date until when the register is active.

decimalPlaces (Int)

The number of decimal places on the register.

digits (Int)

The number of digits on the register.

obisCode (String)

The OBIS code of the register.

readings (RegisterReadingConnectionTypeConnection)

The readings for a given register, in reverse order (latest first).

This field is a connection type. Connections are used to implement cursor based pagination.

This field requires the Authorization header to be set.

Example

{
  "obisCode": "abc123",
  "digits": 1,
  "decimalPlaces": 1,
  "activeFrom": "2020-01-01",
  "activeTo": "2020-01-01",
  "readings": RegisterReadingConnectionTypeConnection
}

Fields

NameDescription

meterId (Int)

The meter id this reading belongs to.

origin (String)

readAt (DateTime!)

registerObisCode (String)

typeOfRead (String)

value (String!)

Example

{
  "value": "abc123",
  "readAt": "2020-01-01T00:00:00.000Z",
  "registerObisCode": "abc123",
  "typeOfRead": "abc123",
  "origin": "abc123",
  "meterId": 1
}

GenericBackendScreen

A generic backend screen that can be used to define any type of screen.

Fields

NameDescription

name (String!)

The name of the screen.

refreshFrequency (Int)

The refresh / polling frequency in milliseconds.

screenData (String)

Serialized JSON representation of the screen.

Example

{
  "name": "abc123",
  "refreshFrequency": 1,
  "screenData": "abc123"
}

GetEmbeddedSecretForNewPaymentInstruction

Get the client secret needed to create a new payment instruction using an embedded form.

The possible errors that can be raised are:

  • KT-CT-4177: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

secretKey (String)

Example

{
  "possibleErrors": [PossibleErrorType],
  "secretKey": "abc123"
}

GetHostedUrlForNewPaymentInstruction

Get external URL where the user can set up a payment instruction.

The possible errors that can be raised are:

  • KT-CT-1128: Unauthorized.
  • KT-CT-3822: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

url (String)

URL at which payment instruction can be set up.

Example

{
  "possibleErrors": [PossibleErrorType],
  "url": "abc123"
}

Fields

NameDescription

currency (String)

Currency.

grossAmount (Float)

Gross amount.

netAmount (Float)

Net amount.

type (String)

Grant type.

Example

{
  "type": "abc123",
  "netAmount": 1.0,
  "grossAmount": 1.0,
  "currency": "abc123"
}

Fields

NameDescription

availableFrom (Date)

Product available from.

availableTo (Date)

Product available to.

code (String)

Product code.

currency (String)

Currency.

customerName (String)

Product customer name.

description (String)

Product description.

grossPricePerUnit (Float)

Gross price per unit.

id (Int)

Product ID.

internalName (String)

Product internal name.

marketName (String)

Market of the product.

notes (String)

Product notes.

pricePerUnit (Float)

Price per unit.

productType (GoodsProductType)

Type of the product.

Example

{
  "id": 1,
  "marketName": "abc123",
  "productType": GoodsProductType,
  "code": "abc123",
  "internalName": "abc123",
  "customerName": "abc123",
  "notes": "abc123",
  "description": "abc123",
  "availableFrom": "2020-01-01",
  "availableTo": "2020-01-01",
  "pricePerUnit": 1.0,
  "grossPricePerUnit": 1.0,
  "currency": "abc123"
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([GoodsProductConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": GoodsProductConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

GoodsProductConnectionTypeEdge

A Relay edge containing a GoodsProductConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (GoodsProduct)

The item at the end of the edge

Example

{
  "node": GoodsProduct,
  "cursor": "abc123"
}

Fields

NameDescription

code (String)

Product type code.

internalName (String)

Product type name.

Example

{
  "code": "abc123",
  "internalName": "abc123"
}

Fields

NameDescription

clientParams (JSONString)

Client parameters of the purchase.

code (String)

Purchase code.

goodsGrants ([GoodsGrant])

Grants that apply in this purchase.

goodsSaleItems ([GoodsSaleItem])

Sale items in this purchase.

ledgerId (String)

Ledger ID associated to the purchase.

marketParams (JSONString)

Market parameters of the purchase.

Example

{
  "code": "abc123",
  "ledgerId": "abc123",
  "goodsSaleItems": [GoodsSaleItem],
  "goodsGrants": [GoodsGrant],
  "marketParams": {"key": "value"},
  "clientParams": {"key": "value"}
}

Fields

NameDescription

code (String)

Code of the quote.

goodsQuotedProducts ([GoodsQuotedProduct])

Products of this quote.

hasQuoteExpired (Boolean)

Indicates whether or not the quote is expired.

id (Int)

ID of the quote.

quotedAt (DateTime)

Date and time when the quote was created.

totalNetAmount (Int)

Total net amount of the quote in cents.

Example

{
  "id": 1,
  "code": "abc123",
  "totalNetAmount": 1,
  "quotedAt": "2020-01-01T00:00:00.000Z",
  "goodsQuotedProducts": [GoodsQuotedProduct],
  "hasQuoteExpired": true
}

Fields

NameDescription

id (Int)

The ID of the quote share.

Example

{
  "id": 1
}

Fields

NameDescription

currency (String)

Currency.

netAmount (Int)

Net amount.

numberOfUnits (Int)

Number of units.

pricePerUnit (Int)

Price per unit.

product (String)

Product code.

Example

{
  "product": "abc123",
  "numberOfUnits": 1,
  "pricePerUnit": 1,
  "netAmount": 1,
  "currency": "abc123"
}

Fields

NameDescription

currency (String)

Currency.

grossAmount (Float)

Gross amount.

netAmount (Float)

Net amount.

numberOfUnits (Int)

Number of units.

pricePerUnit (Float)

Price per unit.

product (String)

Product code.

Example

{
  "product": "abc123",
  "numberOfUnits": 1,
  "pricePerUnit": 1.0,
  "netAmount": 1.0,
  "grossAmount": 1.0,
  "currency": "abc123"
}

Fields

NameDescription

date (Date!)

The date when the VAT rate starts being active from.

grossRate (Decimal!)

The rate after the VAT rate is applied to the net rate.

rateValidToDate (Date)

The date until which the VAT rate is active (exclusive).

vatRate (Decimal!)

The VAT rate percentage.

Example

{
  "date": "2020-01-01",
  "vatRate": 1.0,
  "grossRate": 1.0,
  "rateValidToDate": "2020-01-01"
}

HardshipAgreementType

Represents a Hardship Agreement for a particular Account.

Fields

NameDescription

hardshipDetails (String!)

These are internal notes detailing the hardship.

hardshipEntryReason (HardshipAgreementHardshipEntryReason)

hardshipType (HardshipAgreementHardshipType!)

id (ID!)

paymentPlanDetails (String!)

startDate (Date!)

Example

{
  "id": "abc123",
  "hardshipType": "DEATH_IN_FAMILY",
  "hardshipDetails": "abc123",
  "hardshipEntryReason": "SELF_IDENTIFIED",
  "paymentPlanDetails": "abc123",
  "startDate": "2020-01-01"
}

Fields

NameDescription

isHeld (Boolean)

Whether a statement is currently held.

reason (String)

Reason for statement being held.

Example

{
  "isHeld": true,
  "reason": "abc123"
}

ImageType

A media element containing an image.

Fields

NameDescription

accessibilityHidden (Boolean)

Whether the element is hidden from view.

accessibilityLabel (String)

Accessible description of the element.

horizontalAlignment (Alignment)

The horizontal alignment of the media.

id (ID)

Unique identifier of the object.

mediaUrl (String!)

The resource URL of the media.

typename (String)

The name of the object's type.

width (ItemSizeType)

The measurement of the element.

Example

{
  "width": FractionSizeType,
  "mediaUrl": "abc123",
  "horizontalAlignment": "START",
  "accessibilityHidden": true,
  "accessibilityLabel": "abc123",
  "id": "abc123",
  "typename": "abc123"
}

InitiateHostedStandalonePayment

Initiate a standalone payment and return the client secret required to complete it.

The possible errors that can be raised are:

  • KT-CT-1128: Unauthorized.
  • KT-CT-3822: Unauthorized.
  • KT-CT-3943: Invalid ledger.
  • KT-CT-3957: No collection method provided.
  • KT-CT-3958: Provide either ledger ID or ledger number.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

payment (InitiateHostedStandalonePaymentOutput)

The details required to refer to and complete a hosted payment.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "payment": InitiateHostedStandalonePaymentOutput
}

InitiateHostedStandalonePaymentOutput

Tokens required to collect and retrieve a standalone payment.

Fields

NameDescription

retrievalToken (String!)

The retrieval token for this standalone payment.

url (String!)

The url for the customer to complete the payment.

Example

{
  "retrievalToken": "abc123",
  "url": "abc123"
}

InitiateProductSwitch

The possible errors that can be raised are:

  • KT-CT-1111: Unauthorized.
  • KT-CT-4619: Quote with given code not found.
  • KT-CT-4624: Unable to accept the given product code.
  • KT-CT-4626: No product selected for the given quote code.
  • KT-CT-4719: No supply point found for identifier provided.
  • KT-CT-4922: Unauthorized.
  • KT-CT-1507: Agreement product switch date is not within the acceptable range.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

productCode (String!)

The selected product for a specific product switch.

switchDate (Date!)

The date at which the product switch becomes effective.

Example

{
  "possibleErrors": [PossibleErrorType],
  "productCode": "abc123",
  "switchDate": "2020-01-01"
}

InitiateStandalonePayment

Initiate a standalone payment and return the client secret required to complete it.

The possible errors that can be raised are:

  • KT-CT-4177: Unauthorized.
  • KT-CT-3943: Invalid ledger.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

payment (InitiateStandalonePaymentOutput)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "payment": InitiateStandalonePaymentOutput
}

InitiateStandalonePaymentOutput

Tokens required to collect and retrieve a standalone payment.

Fields

NameDescription

retrievalToken (String!)

The retrieval token for this standalone payment.

secretToken (String!)

The secret used to collect the payment.

Example

{
  "retrievalToken": "abc123",
  "secretToken": "abc123"
}

Fields

NameDescription

all ([InkContactChannelIdentity!]!)

All contacts for this conversation.

default (InkContactChannelIdentity)

The default contact for this conversation.


Fields

NameDescription

channel (InkCommunicationChannel!)

The channel of the contact.

displayName (String!)

The name to display to the user.

handle (String!)

The handle.

Example

{
  "channel": "EMAIL",
  "handle": "abc123",
  "displayName": "abc123"
}

Fields

NameDescription

accountUsers ([AccountUserType!])

The account users on the conversation.

buckets ([InkBucket!])

The buckets the conversation is currently in.

contactChannelIdentities (InkContactChannelIdentities!)

The contact channel identities associated with this conversation.

events (InkConversationEventsConnection!)

Conversation events.

id (ID!)

status (InkConversationStatus!)

The status of the conversation.

Example

{
  "id": "abc123",
  "status": "OPEN",
  "contactChannelIdentities": InkContactChannelIdentities,
  "accountUsers": [AccountUserType],
  "events": InkConversationEventsConnection,
  "buckets": [InkBucket]
}

Fields

NameDescription

edges ([InkConversationEventsEdge!]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

Example

{
  "pageInfo": PageInfo,
  "edges": InkConversationEventsEdge
}

InkConversationEventsEdge

A Relay edge containing a InkConversationEvents and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (InkConversationEvent!)

The item at the end of the edge

Example

{
  "node": InkNewMessage,
  "cursor": "abc123"
}

InkEmail

This type wraps around the Message type for emails.

Fields

NameDescription

attachments ([InkMessageAttachment!]!)

Attachments on the message.

cc ([String!]!)

CC recipients on the message.

contactChannelIdentity (InkContactChannelIdentity!)

The contact channel identity.

delivery (InkMessageDelivery!)

The delivery status of the message.

direction (InkMessageDirection!)

The direction of the email.

displayContent (String!)

The content of the message.

fromHandle (String!)

From email address.

isChannelEmail (Boolean!)

Is this an message an email.

occurredAt (DateTime!)

The time the message was sent/received.

subject (String!)

The email subject.

tags ([InkTag!]!)

All Tags associated with a message.

toHandles ([String!])

The addresses that the message was sent to.

Example

{
  "direction": "INBOUND",
  "toHandles": ["abc123"],
  "fromHandle": "abc123",
  "delivery": InkMessageDelivery,
  "contactChannelIdentity": InkContactChannelIdentity,
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "subject": "abc123",
  "displayContent": "abc123",
  "attachments": InkMessageAttachment,
  "cc": "abc123",
  "isChannelEmail": true,
  "tags": InkTag
}

InkGenericMessage

This message type is used for messages that belong to contact channels without a more granular message type.

Fields

NameDescription

contactChannelIdentity (InkContactChannelIdentity!)

The contact channel identity.

delivery (InkMessageDelivery!)

The delivery status.

direction (InkMessageDirection!)

The direction of the message.

displayContent (String!)

The content of the message.

fromHandle (String!)

The identity the message was sent from.

id (ID!)

The ID of the object

occurredAt (DateTime!)

The time the message was sent/received at.

toHandle (String!)

The identity the message was sent to.

Example

{
  "id": "abc123",
  "direction": "INBOUND",
  "fromHandle": "abc123",
  "toHandle": "abc123",
  "delivery": InkMessageDelivery,
  "contactChannelIdentity": InkContactChannelIdentity,
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "displayContent": "abc123"
}

InkLine

This type wraps around the Message type for LINE message.

Fields

NameDescription

attachments ([InkMessageAttachment!]!)

Attachments on the LINE message.

contactChannelIdentity (InkContactChannelIdentity!)

The contact channel identity.

delivery (InkMessageDelivery!)

The delivery status of the message.

direction (InkMessageDirection!)

The direction of the message.

fromHandle (String!)

From LINE id.

isChannelLine (Boolean!)

Is this a LINE message.

lineMessage (LineMessage!)

The line message content.

occurredAt (DateTime!)

The time the message was sent/received.

tags ([InkTag!]!)

All Tags associated with a message.

toHandle (String!)

To LINE id.

Example

{
  "direction": "INBOUND",
  "fromHandle": "abc123",
  "toHandle": "abc123",
  "delivery": InkMessageDelivery,
  "contactChannelIdentity": InkContactChannelIdentity,
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "lineMessage": LineTextMessage,
  "isChannelLine": true,
  "attachments": InkMessageAttachment,
  "tags": InkTag
}

Fields

NameDescription

fetchUrl (String)

The url for fetching the attachment.

filename (String!)

The filename.

sizeInBytes (Int)

The size in bytes.

Example

{
  "filename": "abc123",
  "fetchUrl": "abc123",
  "sizeInBytes": 1
}

Fields

NameDescription

status (InkMessageDeliveryStatus!)

Message delivery status.

Example

{
  "status": "PENDING"
}

InkNewMessage

This types is used for both the message-received and message-sent conversation events.

Fields

NameDescription

message (InkMessage!)

The message.

occurredAt (DateTime!)

The time the conversation event occurred.

Example

{
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "message": InkEmail
}

InkPost

This type wraps around the Message type for Post.

Fields

NameDescription

contactChannelIdentity (InkContactChannelIdentity!)

The contact channel identity.

displayContent (String!)

The notes left when a message was uploaded.

fromHandle (String!)

The from property id.

isChannelPost (Boolean!)

Determine if the message is a post message.

rawPlainTextContent (String!)

The content of the message.

toHandle (String!)

The to property id.

Example

{
  "fromHandle": "abc123",
  "toHandle": "abc123",
  "displayContent": "abc123",
  "rawPlainTextContent": "abc123",
  "isChannelPost": true,
  "contactChannelIdentity": InkContactChannelIdentity
}

InkSMS

This type wraps around the Message type for SMS.

Fields

NameDescription

contactChannelIdentity (InkContactChannelIdentity!)

The contact channel identity.

delivery (InkMessageDelivery!)

The delivery status.

direction (InkMessageDirection!)

The direction of the message.

displayContent (String!)

The content of the message.

fromHandle (String!)

The phone number the message was sent from.

isChannelSms (Boolean!)

Is this an SMS message.

occurredAt (DateTime!)

The time the message was sent/received at.

tags ([InkTag!]!)

All Tags associated with a message.

toHandle (String!)

The phone number the message was sent to.

Example

{
  "direction": "INBOUND",
  "fromHandle": "abc123",
  "toHandle": "abc123",
  "delivery": InkMessageDelivery,
  "contactChannelIdentity": InkContactChannelIdentity,
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "displayContent": "abc123",
  "isChannelSms": true,
  "tags": InkTag
}

InkWhatsApp

This type wraps around the Message type for WhatsApp message.

Fields

NameDescription

contactChannelIdentity (InkContactChannelIdentity!)

Whatsapp message contact channel identity.

delivery (InkMessageDelivery!)

Whatsapp message delivery status.

direction (InkMessageDirection!)

The direction of the message.

fromHandle (String!)

From WhatsApp phone number.

isChannelWhatsapp (Boolean!)

Whether or not the message is a whatsapp message.

occurredAt (DateTime!)

Date when the conversation event was created.

tags ([InkTag!]!)

All Tags associated with a message.

toHandle (String!)

Whatsapp contact phone number.

vendorId (String)

The vendor id.

whatsappContent (WhatsAppTextMessage!)

Whatsapp message content.

Example

{
  "direction": "INBOUND",
  "fromHandle": "abc123",
  "toHandle": "abc123",
  "delivery": InkMessageDelivery,
  "contactChannelIdentity": InkContactChannelIdentity,
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "vendorId": "abc123",
  "whatsappContent": WhatsAppTextMessage,
  "isChannelWhatsapp": true,
  "tags": InkTag
}

Fields

NameDescription

accumulation (Decimal)

durationInSeconds (Int!)

endAt (DateTime!)

metaData (MeasurementsMetadataOutput)

This type will return more granular data about the measurement.

readAt (DateTime!)

source (String!)

startAt (DateTime!)

unit (String!)

value (Decimal!)

Example

{
  "source": "abc123",
  "metaData": MeasurementsMetadataOutput,
  "value": 1.0,
  "unit": "abc123",
  "readAt": "2020-01-01T00:00:00.000Z",
  "startAt": "2020-01-01T00:00:00.000Z",
  "endAt": "2020-01-01T00:00:00.000Z",
  "durationInSeconds": 1,
  "accumulation": 1.0
}

InvalidatePaymentInstruction

Invalidates a payment instruction.

The possible errors that can be raised are:

  • KT-CT-3926: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

instruction (InvalidatePaymentInstructionOutput)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "instruction": InvalidatePaymentInstructionOutput
}

InvalidatePaymentInstructionOutput

Output for invalidating an arbitrary payment instruction.

Fields

NameDescription

id (Int)

Example

{
  "id": 1
}

InvoiceBillingDocumentConnectionTypeConnection

An invoice is a bill that contains individual transactions (i.e. charges, credits, payments, and repayments). These may come from any period of time.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([InvoiceBillingDocumentConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": InvoiceBillingDocumentConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

InvoiceBillingDocumentConnectionTypeEdge

A Relay edge containing a InvoiceBillingDocumentConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (InvoiceBillingDocumentType)

The item at the end of the edge

Example

{
  "node": InvoiceBillingDocumentType,
  "cursor": "abc123"
}

InvoiceBillingDocumentType

An invoice is a bill that contains individual transactions (i.e. charges, credits, payments, and repayments). These may come from any period of time.

Fields

NameDescription

annulledBy (AnnulmentBillingDocumentType)

Billing document that annuls this invoice.

billingFrom (DateTime)

Start date of billing period.

billingTo (DateTime)

End date of billing period.

firstIssued (DateTime)

First time the invoice was issued.

id (Int)

invoicedAmount (Int)

The invoiced amount of the billing document.

number (String)

The unique billing document's reference that can be used for identifying it externally.

pdfUrl (String)

URL to the PDF of the Invoice.

Example

{
  "id": 1,
  "firstIssued": "2020-01-01T00:00:00.000Z",
  "pdfUrl": "abc123",
  "annulledBy": AnnulmentBillingDocumentType,
  "number": "abc123",
  "invoicedAmount": 1,
  "billingFrom": "2020-01-01T00:00:00.000Z",
  "billingTo": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

attachments (BillingAttachmentConnectionTypeConnection)

billType (BillTypeEnum)

The type of the bill.

fromDate (Date)

The date of the bill is covered from.

grossAmount (Int)

This field returns the total gross amount of the bill in pence.

id (ID)

The ID of the bill.

issuedDate (Date)

The date the bill was sent to the customer.

temporaryUrl (String)

Requesting this field generates a temporary URL at which bill is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page). This field can raise an error with errorClass NOT_FOUND if the bill document has not been created/issued yet. This field is deprecated use 'attachments' field instead.

Deprecated

The 'temporaryUrl' field is deprecated.

This field is deprecated. Use the 'attachments' field instead.

- Marked as deprecated on 2024-09-16.
- Will be removed on 2025-09-01.

toDate (Date)

The date of the bill is covered to.

Example

{
  "id": "abc123",
  "billType": "STATEMENT",
  "fromDate": "2020-01-01",
  "toDate": "2020-01-01",
  "temporaryUrl": "abc123",
  "issuedDate": "2020-01-01",
  "attachments": BillingAttachmentConnectionTypeConnection,
  "grossAmount": 1
}

Fields

NameDescription

result (Boolean)

Indicator that the mutation has completed successfully.

Example

{
  "result": true
}

JoinSupplierProcessConnectionTypeEdge

A Relay edge containing a JoinSupplierProcessConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (JoinSupplierProcessType)

The item at the end of the edge

Example

{
  "node": JoinSupplierProcessType,
  "cursor": "abc123"
}

Fields

NameDescription

chargePointMake (String)

chargePointModel (String)

chargePointPowerInKw (Decimal)

createdAt (DateTime)

hasToken (Boolean)

krakenflexDeviceId (String)

provider (ProviderChoices)

The third party that provides control over this device.

stateOfChargeLimit (StateOfChargeLimit)

Maximum state of charge (SoC) limit telemetry.

status (String)

suspended (Boolean)

testDispatchFailureReason (TestDispatchAssessmentFailureReason)

The reason for the most recent failed test dispatch (if any).

vehicleBatterySizeInKwh (Decimal)

vehicleMake (String)

vehicleModel (String)

Example

{
  "krakenflexDeviceId": "abc123",
  "provider": "DAIKIN",
  "vehicleMake": "abc123",
  "vehicleModel": "abc123",
  "vehicleBatterySizeInKwh": 1.0,
  "chargePointMake": "abc123",
  "chargePointModel": "abc123",
  "chargePointPowerInKw": 1.0,
  "status": "abc123",
  "suspended": true,
  "hasToken": true,
  "createdAt": "2020-01-01T00:00:00.000Z",
  "stateOfChargeLimit": StateOfChargeLimit,
  "testDispatchFailureReason": "NONE"
}

KrakenVersionType

Information about what version of Kraken is being executed by this service.

Fields

NameDescription

SHA (String)

The git commit SHA that is being executed.

number (String)

The version number that is being executed.

Example

{
  "number": "abc123",
  "SHA": "abc123"
}

LeavePropertyProcessConnectionTypeEdge

A Relay edge containing a LeavePropertyProcessConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (LeavePropertyProcessType)

The item at the end of the edge

Example

{
  "node": LeavePropertyProcessType,
  "cursor": "abc123"
}

LeaveSupplierProcessConnectionTypeEdge

A Relay edge containing a LeaveSupplierProcessConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (LeaveSupplierProcessType)

The item at the end of the edge

Example

{
  "node": LeaveSupplierProcessType,
  "cursor": "abc123"
}

LedgerType

Ledgers provide the foundation of Kraken’s bookkeeping functionality. Similar to a bank account, they allow us to keep track of financial activity on a particular Kraken account.

Fields

NameDescription

affectsAccountBalance (Boolean)

Whether this ledger's balance contributes to the account's balance.

amountOwedByCustomer (Int)

The amount owed from the customer perspective. A positive value implies the customer owes the business, while a negative amount implies the customer is in credit.

balance (Int)

The current balance on the ledger in minor units of currency.

id (ID)

invoices (InvoiceBillingDocumentConnectionTypeConnection)

An invoice is a bill that contains individual transactions (i.e. charges, credits, payments, and repayments). These may come from any period of time.

ledgerType (String)

The ledger type code.

name (String)

The display name of the ledger.

number (String)

The canonical name of the ledger.

paymentAdequacy (PaymentAdequacyDetailsType)

refundRequests (RefundRequestConnectionTypeConnection)

Refund requests for a given ledger.

repaymentRequests (RepaymentRequestConnectionTypeConnection)

Repayment requests for a given ledger.

statements (StatementBillingDocumentConnectionTypeConnection)

A statement is a billing document that contains all entries on a ledger during a period of time. A customer can understand how their ledger's balance has changed by looking at each statement in series.

transactions (TransactionConnectionTypeConnection)

Example

{
  "id": "abc123",
  "name": "abc123",
  "number": "abc123",
  "ledgerType": "abc123",
  "balance": 1,
  "amountOwedByCustomer": 1,
  "affectsAccountBalance": true,
  "statements": StatementBillingDocumentConnectionTypeConnection,
  "invoices": InvoiceBillingDocumentConnectionTypeConnection,
  "transactions": TransactionConnectionTypeConnection,
  "repaymentRequests": RepaymentRequestConnectionTypeConnection,
  "refundRequests": RefundRequestConnectionTypeConnection,
  "paymentAdequacy": PaymentAdequacyDetailsType
}

LineCommonError

A base error type. Should be used for general application or lower level errors.

Fields

NameDescription

field (String)

The field that for which this error should be associated.

message (String!)

The error message to display to the user.

Example

{
  "message": "abc123",
  "field": "abc123"
}

LineEmoji

A LINE specific emoji object. refs: https://developers.line.biz/en/reference/messaging-api/#text-message

Fields

NameDescription

emojiId (String!)

The emoji id.

index (Int!)

The location of the emoji in the message.

length (Int)

The length of the emoji string placeholder.

productId (String!)

The product id.

Example

{
  "index": 1,
  "length": 1,
  "productId": "abc123",
  "emojiId": "abc123"
}

Fields

NameDescription

id (ID!)

Example

{
  "id": "abc123"
}

LineLinkRedirectResponse

Link Successful. Complete link process with LINE.

Fields

NameDescription

redirectUrl (String!)

Example

{
  "redirectUrl": "abc123"
}

Fields

NameDescription

keywords ([String!]!)

Keywords describing the sticker.

packageId (String!)

Sticker package id.

resourceType (String!)

Sticker resource type.

stickerId (String!)

Sticker id.

text (String!)

Text used to customize some stickers.

Example

{
  "packageId": "abc123",
  "stickerId": "abc123",
  "resourceType": "abc123",
  "keywords": "abc123",
  "text": "abc123"
}

Fields

NameDescription

displayContent (String!)

The display content.

emojis ([LineEmoji!])

The emojis in the message.

Example

{
  "displayContent": "abc123",
  "emojis": [LineEmoji]
}

Fields

NameDescription

message (String!)

Example

{
  "message": "abc123"
}

LinkActionType

An action which navigates to any URL.

Fields

NameDescription

id (ID)

Unique identifier of the object.

typeName (String)

The name of the action object's type.

typename (String)

The name of the object's type.

url (String!)

The URL to navigate to.

Example

{
  "typeName": "abc123",
  "id": "abc123",
  "typename": "abc123",
  "url": "abc123"
}

LinkTokenNotFound

Returned when no LineAccountLink record matching the parameters exists.

Fields

NameDescription

type (LineLinkErrorType!)

The type of error that occurred.

Example

{
  "type": "NO_MATCHING_LINE_LINK"
}

LoyaltyPointLedgerEntryType

A Loyalty Point ledger entry.

Fields

NameDescription

accountNumber (String)

The account number associated with the entry.

balanceBroughtForward (String)

Equal to the balance_carried_forward from the previous ledger entry or zero if this is the first one.

balanceCarriedForward (String)

Equal to the balance_brought_forward plus or minus the value depending on the ledger_type.

id (ID!)

ledgerType (String)

The LedgerEntryType. Either CHARGE or CREDIT.

postedAt (DateTime)

The date the points were added to the ledger.

reasonCode (String)

The reason the entry was being added.

value (String)

The value of the charge or credit.

Example

{
  "id": "abc123",
  "ledgerType": "abc123",
  "value": "abc123",
  "balanceBroughtForward": "abc123",
  "balanceCarriedForward": "abc123",
  "reasonCode": "abc123",
  "postedAt": "2020-01-01T00:00:00.000Z",
  "accountNumber": "abc123"
}

Fields

NameDescription

agreements ([Agreement])

canBeAnnulled (Boolean)

Whether the MaLo's supply point can currently be annulled.

canBeCancelled (Boolean)

Whether the MaLo's supply point can currently be cancelled.

canBeRevoked (Boolean)

Whether the MaLo's supply point can currently be revoked.

canBeSpeciallyCancelled (Boolean)

Whether the MaLo's supply point can currently be specially cancelled.

id (ID)

maloNumber (String)

The MaLo number.

meloNumber (String)

The MeLo number.

meter (Meter)

The currently active meter.

referenceConsumption (Int)

The reference consumption related to energy price brake.

status (String)

supplyPointId (ID)

ID of the supply point.

supplyStartDate (Date)

The supply start date, either of the currently active supply period, a future supply period, or a past supply period. The date is returned in the local timezone. Null if no supply period is available.

Example

{
  "id": "abc123",
  "status": "abc123",
  "maloNumber": "abc123",
  "meloNumber": "abc123",
  "meter": Meter,
  "agreements": [Agreement],
  "supplyStartDate": "2020-01-01",
  "supplyPointId": "abc123",
  "canBeAnnulled": true,
  "canBeRevoked": true,
  "canBeCancelled": true,
  "canBeSpeciallyCancelled": true,
  "referenceConsumption": 1
}

Fields

NameDescription

errors ([ErrorType])

A list of any errors that occurred while running this mutation.

token (String)

A Kraken Token that can be used to authenticate to the API, masquerading as the desired user.

Example

{
  "token": "abc123",
  "errors": [ErrorType]
}

Fields

NameDescription

amount (Int)

The maximum amount available to be requested as a refund.

reasonToRecommendAmount (MaximumRefundReasonChoices)

The reason why a specific amount is the maximum available to be requested as a refund.

recommendedBalance (Int)

The recommended minimum balance an account should have when asking for a refund.

Example

{
  "amount": 1,
  "reasonToRecommendAmount": "MAX_AVAILABLE_AMOUNT",
  "recommendedBalance": 1
}

MeasurementConnection

Pagination for measurements.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([MeasurementEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": MeasurementEdge,
  "totalCount": 1,
  "edgeCount": 1
}

MeasurementEdge

A Relay edge containing a Measurement and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (MeasurementInterface)

The item at the end of the edge

Example

{
  "node": MeasurementInterface,
  "cursor": "abc123"
}

Fields

NameDescription

metaData (MeasurementsMetadataOutput)

This type will return more granular data about the measurement.

readAt (DateTime!)

source (String!)

unit (String!)

value (Decimal!)

Example

{
  "source": "abc123",
  "metaData": MeasurementsMetadataOutput,
  "value": 1.0,
  "unit": "abc123",
  "readAt": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

statistics ([StatisticOutput])

Statistics relating to the parent measurement node.

typedSource (TypedSourceOutput)

The source information relating to the parent measurement node.

Deprecated

The 'typedSource' type is deprecated.


Please use 'utilityFilters' and the corresponding filter output instead.


- Marked as deprecated on 2024-06-17.
- Will be removed on 2026-01-30.

utilityFilters (UtilityFiltersOutput)

The source information relating to the parent measurement node.

Example

{
  "typedSource": TypedSourceOutput,
  "utilityFilters": ElectricityFiltersOutput,
  "statistics": [StatisticOutput]
}

Fields

NameDescription

key (String!)

The key for the metadata.

value (JSONString)

The metadata value.

Example

{
  "key": "abc123",
  "value": {"key": "value"}
}

Fields

NameDescription

id (ID)

meterType (String)

number (String)

shouldReceiveSmartMeterData (Boolean)

Whether the meter should receive smart meter data.

submitMeterReadingUrl (String)

A tokenized url for submitting meter readings.

Example

{
  "id": "abc123",
  "number": "abc123",
  "meterType": "abc123",
  "submitMeterReadingUrl": "abc123",
  "shouldReceiveSmartMeterData": true
}

MoveOut

Cancelling a contract because of a Move Out for a given supply point and send confirmation email to the customer.

Fields

NameDescription

cancelledContract (Boolean)

Whether the contract cancellation was successful.

lastDayOfSupply (Date)

The last day of supply.

Example

{
  "cancelledContract": true,
  "lastDayOfSupply": "2020-01-01"
}

NotifiableApplicationType

Represents an application that can receive push notifications.

Fields

NameDescription

bundleId (String!)

Bundle ID or package name of the app.

description (String!)

externalProjectId (String!)

Project ID used in push notification delivery service. (Currently: AWS Pinpoint)

externalProvider (NotifiableApplicationExternalProvider!)

id (ID!)

name (String!)

Human readable name for the app.

pushNotificationBindings ([PushNotificationBindingType!]!)

service (NotifiableApplicationService!)

Example

{
  "id": "abc123",
  "name": "abc123",
  "bundleId": "abc123",
  "service": "GCM",
  "externalProvider": "PINPOINT",
  "externalProjectId": "abc123",
  "description": "abc123",
  "pushNotificationBindings": PushNotificationBindingType
}

OCPPAuthentication

Open Charge Point Protocol (OCPP) authentication.

Take the given OCPP authentication details and trigger OCPP authentication.

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4310: Unable to register OCPP authentication details.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

Fields

NameDescription

isConnected (Boolean)

Example

{
  "isConnected": true
}

Fields

NameDescription

url (String)

username (String)

Example

{
  "url": "abc123",
  "username": "abc123"
}

Fields

NameDescription

brandCode (String)

createdAt (DateTime!)

effectiveFrom (DateTime)

html (String)

The html of the terms and conditions document rendered as a JSON string.

markdown (String)

The markdown text of the terms and conditions.

name (String)

pdfUrl (String)

text (String!)

version (String)

Example

{
  "text": "abc123",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "name": "abc123",
  "pdfUrl": "abc123",
  "brandCode": "abc123",
  "markdown": "abc123",
  "html": "abc123",
  "version": "abc123",
  "effectiveFrom": "2020-01-01T00:00:00.000Z"
}

ObtainKrakenJSONWebToken

The unifying approach used to get a Kraken token (JWT: JSON Web Token) with different types of input.

The currently supported inputs are: - account user email/password combination - account user API key - organization live secret key - pre-signed key - refresh token

The possible errors that can be raised are:

  • KT-CT-1135: Invalid data.
  • KT-CT-1134: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

payload (GenericScalar!)

The body payload of the Kraken Token. The same information can be obtained by using JWT decoding tools on the value of the token field.

possibleErrors ([PossibleErrorType])

refreshExpiresIn (Int)

A Unix timestamp representing the point in time at which the refresh token will expire.

refreshToken (String)

A token that can be used in a subsequent call to obtainKrakenToken to get a new Kraken Token with the same access conditions after the previous one has expired.

token (String!)

The Kraken Token. Can be used in the Authorization header for subsequent calls to the API to access protected resources.

Example

{
  "possibleErrors": [PossibleErrorType],
  "token": "abc123",
  "payload": "abc123" | 1 | 1.0 | true | ["abc123"] | AccountType,
  "refreshToken": "abc123",
  "refreshExpiresIn": 1
}

OccupancyPeriodType

An occupancy period for a property.

Fields

NameDescription

effectiveFrom (DateTime)

Date the occupancy period is effective from.

effectiveTo (DateTime)

Date the occupancy period is effective to.

id (ID)

isOccupier (Boolean)

Whether the account associated with the occupancy period is an occupier account type.

Example

{
  "id": "abc123",
  "effectiveFrom": "2020-01-01T00:00:00.000Z",
  "effectiveTo": "2020-01-01T00:00:00.000Z",
  "isOccupier": true
}

OccupyPropertyProcessConnectionTypeEdge

A Relay edge containing a OccupyPropertyProcessConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (OccupyPropertyProcessType)

The item at the end of the edge

Example

{
  "node": OccupyPropertyProcessType,
  "cursor": "abc123"
}

PageInfo

The Relay compliant PageInfo type, containing data necessary to paginate this connection.

Fields

NameDescription

endCursor (String)

When paginating forwards, the cursor to continue.

hasNextPage (Boolean!)

When paginating forwards, are there more items?

hasPreviousPage (Boolean!)

When paginating backwards, are there more items?

startCursor (String)

When paginating backwards, the cursor to continue.

Example

{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "startCursor": "abc123",
  "endCursor": "abc123"
}

Payment

A payment from the customer to the energy supplier.

Fields

NameDescription

accountNumber (String)

Unique identifier of the account the transaction belongs to.

amount (Int)

Gross amount including tax (when payable). Refer to the amounts field for a breakdown of this information.

Deprecated

The 'amount' field is deprecated.

Use `amounts` instead for a breakdown of the relevant net, tax, and gross amounts.

- Marked as deprecated on 2023-12-06.
- Will be removed on 2024-06-01.

amounts (TransactionAmountType)

The net, tax and gross amounts for the transaction. Note: for payments and repayments, only the net amount is returned.

balanceCarriedForward (Int)

The customer's resulting balance after this transaction has been applied, in the smallest unit of currency.

billingDocumentIdentifier (ID)

The unique identifier for the most recent billing document linked with the transaction.Note: a transaction may be linked with multiple documents, but this field will only return the identifier for the most recent billing document.

createdAt (DateTime)

The date time when the transaction is created.

hasStatement (Boolean)

Returns True if the transaction is linked with a statement.

id (ID)

isAccountCharge (Boolean)

Deprecated.

Deprecated

The 'isAccountCharge' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isAccountPayment (Boolean)

Deprecated.

Deprecated

The 'isAccountPayment' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isCredit (Boolean)

Deprecated.

Deprecated

The 'isCredit' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isHeld (Boolean)

Whether the statement this transaction is on has been held. A held statement is not sent to a customer automatically, but is instead marked for manual attention by operations staff. Returns False if a statement is not linked with the transaction.

isIssued (Boolean)

Whether this transaction has been issued on any billing document.Note: Look for the most recently issued transaction instead of looking through all transactions as some accounts may have initial transactions that were not issued.This will return False if the transaction is not associated with any billing documents.

isReversed (Boolean!)

note (String)

Returns the note field value for the transaction, which contains additional info.

postedDate (Date)

statementId (ID)

Returns None if a statement is not linked with the transaction.

Deprecated

The 'statementId' field is deprecated.

Use `billingDocumentIdentifier` instead.

- Marked as deprecated on 2023-11-30.
- Will be removed on 2024-06-01.

title (String)

Example

{
  "id": "abc123",
  "postedDate": "2020-01-01",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "accountNumber": "abc123",
  "amount": 1,
  "amounts": TransactionAmountType,
  "balanceCarriedForward": 1,
  "isCredit": true,
  "isAccountCharge": true,
  "isAccountPayment": true,
  "isHeld": true,
  "isIssued": true,
  "title": "abc123",
  "billingDocumentIdentifier": "abc123",
  "statementId": "abc123",
  "isReversed": true,
  "hasStatement": true,
  "note": "abc123"
}

PaymentAdequacyDetailsType

Payment adequacy adjusts fixed payment schedules to maintain a healthy ledger balance over a year.

Fields

NameDescription

isCurrentlyExempt (Boolean)

This ledger will be exempt from default Payment Adequacy. This may mean that it is completely exempt, or handled with special rules.

Example

{
  "isCurrentlyExempt": true
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([PaymentForecastConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": PaymentForecastConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

PaymentForecastConnectionTypeEdge

A Relay edge containing a PaymentForecastConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (PaymentForecastType)

The item at the end of the edge

Example

{
  "node": PaymentForecastType,
  "cursor": "abc123"
}

Fields

NameDescription

amount (Int)

date (Date)

method (ScheduleType)

The payment method used for the forecasted payment.

paymentNumber (Int)

Example

{
  "paymentNumber": 1,
  "date": "2020-01-01",
  "amount": 1,
  "method": "BACS_TRANSFER"
}

PaymentInstructionType

Payment Instructions

Fields

NameDescription

accountHolder (String!)

accountType (String)

bankCode (String)

cardExpiryMonth (Int)

cardExpiryYear (Int)

cardNumber (String!)

cardPaymentNetwork (String)

cardType (String)

iban (String!)

id (ID!)

instructionType (String!)

maskedAccountIdentifier (String)

A masked reference to a recurring payment method.

sortCode (String!)

status (String!)

validFrom (DateTime!)

vendor (String!)

The provider to use for this DDI. Most accounts would have SmartDebit as their provider, Iresa customers use GoCardless

Example

{
  "id": "abc123",
  "status": "abc123",
  "sortCode": "abc123",
  "iban": "abc123",
  "accountHolder": "abc123",
  "instructionType": "abc123",
  "cardPaymentNetwork": "abc123",
  "cardExpiryMonth": 1,
  "cardExpiryYear": 1,
  "bankCode": "abc123",
  "accountType": "abc123",
  "validFrom": "2020-01-01T00:00:00.000Z",
  "vendor": "abc123",
  "cardNumber": "abc123",
  "cardType": "abc123",
  "maskedAccountIdentifier": "abc123"
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([PaymentScheduleConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": PaymentScheduleConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

PaymentScheduleConnectionTypeEdge

A Relay edge containing a PaymentScheduleConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (PaymentScheduleType)

The item at the end of the edge

Example

{
  "node": PaymentScheduleType,
  "cursor": "abc123"
}

Fields

NameDescription

description (String)

A human-readable description of the value.

direction (PaymentDayDirectionType)

Direction of payment day.

Example

{
  "direction": "OF_MONTH",
  "description": "abc123"
}

PaymentScheduleType

An object that represents when we have agreed to take payments from a payment instruction.

Fields

NameDescription

id (ID!)

isPaymentHoliday (Boolean)

isVariablePaymentAmount (Boolean!)

paymentAdequacyAdjustment (Int)

paymentAdequacyAdjustmentExpiryDate (Date)

paymentAmount (Int!)

paymentDay (Int)

paymentDayDetails (PaymentSchedulePaymentDayDetailsType)

Details of the payment_day value.

paymentFrequency (PaymentFrequencyOptions)

The frequency of the payment schedule.

paymentFrequencyMultiplier (Int!)

paymentHolidayReason (String!)

reason (PaymentScheduleReasonOptions)

The reason the payment schedule was created.

scheduleType (ScheduleType)

The method of payment for the schedule.

supplementaryLedger (SupplementaryLedgerType)

The supplementary ledger for this payment schedule, if it is on one.

totalDebtAmount (Int)

The sum of the payment adequacy contributions on the payment schedule that are expected to be taken before the debt repayment is complete.

validFrom (Date!)

validTo (Date)

Example

{
  "id": "abc123",
  "supplementaryLedger": SupplementaryLedgerType,
  "validFrom": "2020-01-01",
  "validTo": "2020-01-01",
  "reason": "GENERAL_ACCOUNT_PAYMENT",
  "paymentHolidayReason": "abc123",
  "paymentDay": 1,
  "paymentFrequency": "Weekly",
  "paymentFrequencyMultiplier": 1,
  "paymentAmount": 1,
  "paymentAdequacyAdjustment": 1,
  "paymentAdequacyAdjustmentExpiryDate": "2020-01-01",
  "isVariablePaymentAmount": true,
  "totalDebtAmount": 1,
  "isPaymentHoliday": true,
  "scheduleType": "BACS_TRANSFER",
  "paymentDayDetails": PaymentSchedulePaymentDayDetailsType
}

PerformBoostCharge

Initiate a boost charge for an electric vehicle (EV).

This will start charging the EV and will not stop until the battery reaches 100% charged.

If it is not possible to initiate a boost charge, a KT-CT-4357 error will be returned. It may have a boostChargeRefusalReasons extension which lists the reasons why the boost charge was refused. Possible reasons include:

  • BC_DEVICE_NOT_YET_LIVE (device is not yet live)
  • BC_DEVICE_RETIRED (device is retired)
  • BC_DEVICE_SUSPENDED (device is suspended)
  • BC_DEVICE_DISCONNECTED (device is disconnected)
  • BC_DEVICE_NOT_AT_HOME (device is not at home)
  • BC_BOOST_CHARGE_IN_PROGRESS (boost charge already in progress)

The possible errors that can be raised are:

  • KT-CT-4356: A boost charge cannot currently be performed.
  • KT-CT-4357: Unable to trigger boost charge.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

PerformHouseMove

Performs a house move.

The possible errors that can be raised are:

  • KT-CT-4178: No account found with given account number.
  • KT-CT-4410: Invalid postcode.
  • KT-CT-3811: Invalid IBAN.
  • KT-CT-3822: Unauthorized.
  • KT-DE-4903: Unable to proceed.
  • KT-DE-3920: No active or pending agreement found.
  • KT-DE-3921: Unable to proceed.
  • KT-DE-4904: Unable to proceed.
  • KT-DE-4905: Unable to proceed.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType]
}

PerformTestCharge

Initiate a test charge of an electric vehicle (EV).

This is to ensure that the EV or EVSE (charge point) can be controlled remotely and successfully charged for a short period.

If it is not possible to initiate a test charge, a KT-CT-4355 error will be returned. It may have a testChargeRefusalReasons extension which lists the reasons why the test charge was refused. Possible reasons include:

  • TC_DEVICE_LIVE (device is already live)
  • TC_DEVICE_ONBOARDING_IN_PROGRESS (test dispatch already in progress)
  • TC_DEVICE_RETIRED (device is retired)
  • TC_DEVICE_SUSPENDED (device is suspended)
  • TC_DEVICE_DISCONNECTED (device is disconnected)
  • TC_DEVICE_AWAY_FROM_HOME (device is away from home)
  • TC_DEVICE_NO_LOCATION_CONFIGURED (device has no location configured)
  • TC_DEVICE_LOCATION_UNABLE_TO_IDENTIFY (unable to identify device location)
  • TC_DEVICE_LOCATION_MISSING (device location is missing)

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4355: Unable to trigger charge.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

Fields

NameDescription

attachments (BillingAttachmentConnectionTypeConnection)

billType (BillTypeEnum)

The type of the bill.

fromDate (Date)

The date of the constituent bill covered from.

id (ID)

The ID of the constituent bill.

identifier (ID)

The unique identifier for the billing document. Note: a pending billing document will not have an identifier yet; and not all finalized billing documents will have an identifier assigned to them, in which case this will be null.

isAnnulled (Boolean!)

Whether the billing document has been annulled.

issuedDate (Date)

The date the bill was sent to the customer.

temporaryUrl (String)

Requesting this field generates a temporary URL at which bill is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page). This field can raise an error with errorClass NOT_FOUND if the bill document has not been created/issued yet. This field is deprecated use 'attachments' field instead.

Deprecated

The 'temporaryUrl' field is deprecated.

This field is deprecated. Use the 'attachments' field instead.

- Marked as deprecated on 2024-09-16.
- Will be removed on 2025-09-01.

toDate (Date)

The date of the constituent bill covered to.

totalCharges (StatementTotalType)

The total amounts for all charges on the billing document.

totalCredits (StatementTotalType)

The total amounts for all credits on the statement.

Example

{
  "id": "abc123",
  "billType": "STATEMENT",
  "fromDate": "2020-01-01",
  "toDate": "2020-01-01",
  "temporaryUrl": "abc123",
  "issuedDate": "2020-01-01",
  "attachments": BillingAttachmentConnectionTypeConnection,
  "identifier": "abc123",
  "totalCharges": StatementTotalType,
  "totalCredits": StatementTotalType,
  "isAnnulled": true
}

Fields

NameDescription

buttonAction (ActionType!)

The action to perform when the button is pressed.

buttonStyle (ButtonStyle)

The button style.

id (ID)

Unique identifier of the object.

title (String!)

Title text of the button.

typename (String)

The name of the object's type.

Example

{
  "buttonStyle": "PRIMARY",
  "title": "abc123",
  "buttonAction": DeeplinkActionType,
  "id": "abc123",
  "typename": "abc123"
}

Fields

NameDescription

isBlocked (Boolean)

Whether the viewer has been blocked due to spending all its allowed points.

limit (Int)

The maximum number of points the viewer gets for requests per hour.

remainingPoints (Int)

The remaining points for the viewer in one hour time limit.

ttl (Int)

Time To Live: UNIX timestamp when the viewer will get a new allowance of points.

usedPoints (Int)

The points used so far in one hour time limit.

Example

{
  "limit": 1,
  "remainingPoints": 1,
  "usedPoints": 1,
  "ttl": 1,
  "isBlocked": true
}

PointsSizeType

A measurement in points.

Fields

NameDescription

id (ID)

Unique identifier of the object.

points (Int!)

The points value.

typename (String)

The name of the object's type.

Example

{
  "id": "abc123",
  "typename": "abc123",
  "points": 1
}

PortfolioConnectionTypeEdge

A Relay edge containing a PortfolioConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (PortfolioType)

The item at the end of the edge

Example

{
  "node": PortfolioType,
  "cursor": "abc123"
}

Fields

NameDescription

billingName (String)

collectiveBilling (Boolean!)

createdAt (DateTime!)

id (ID!)

leadAccountNumber (String)

The lead account for this portfolio.

number (String!)

operationsTeam (OperationsTeamType)

Operations team for this portfolio.

updatedAt (DateTime!)

Example

{
  "id": "abc123",
  "number": "abc123",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "updatedAt": "2020-01-01T00:00:00.000Z",
  "billingName": "abc123",
  "collectiveBilling": true,
  "operationsTeam": OperationsTeamType,
  "leadAccountNumber": "abc123"
}

PortfolioUserRoleType

The role a user has in association with one portfolio.

Fields

NameDescription

id (ID!)

portfolio (PortfolioType!)

Portfolio object.

role (RoleString)

The portfolio role.

user (AccountUserType!)

Example

{
  "id": "abc123",
  "user": AccountUserType,
  "role": RoleString,
  "portfolio": PortfolioType
}

PossibleErrorType

The GraphQL error type for displaying information about GraphQL errors that might be raised from the API.

Fields

NameDescription

code (String)

The error code that might be returned from the query/mutation.

description (String)

The error description that might be returned from the query/mutation.

message (String)

The error message that might be returned from the query/mutation.

type (String)

The error type that might be returned from the query/mutation.

Example

{
  "message": "abc123",
  "code": "abc123",
  "type": "abc123",
  "description": "abc123"
}

Fields

NameDescription

attachments (BillingAttachmentConnectionTypeConnection)

billType (BillTypeEnum)

The type of the bill.

fromDate (Date)

The date of the bill is covered from.

grossAmount (BigInt)

The gross amount of the historical bill.

id (ID)

The ID of the bill.

issuedDate (Date)

The date the bill was sent to the customer.

params (JSONString)

The params associated with the historical bill.

temporaryUrl (String)

Requesting this field generates a temporary URL at which bill is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page). This field can raise an error with errorClass NOT_FOUND if the bill document has not been created/issued yet. This field is deprecated use 'attachments' field instead.

Deprecated

The 'temporaryUrl' field is deprecated.

This field is deprecated. Use the 'attachments' field instead.

- Marked as deprecated on 2024-09-16.
- Will be removed on 2025-09-01.

toDate (Date)

The date of the bill is covered to.

Example

{
  "id": "abc123",
  "billType": "STATEMENT",
  "fromDate": "2020-01-01",
  "toDate": "2020-01-01",
  "temporaryUrl": "abc123",
  "issuedDate": "2020-01-01",
  "attachments": BillingAttachmentConnectionTypeConnection,
  "params": {"key": "value"},
  "grossAmount": 1
}

Fields

NameDescription

amount (Decimal!)

        Monetary value of a single unit of the measurement.
        This is the smallest unit of currency e.g. cents for USD or yen for JPY.

unit (Unit)

Unit that monetary amount relates to eg. 27 cents per kwh.

Example

{
  "amount": 1.0,
  "unit": "KILOWATT_HOURS"
}

PrintAttachmentType

Represents a print attachment

Fields

NameDescription

filename (String!)

id (ID!)

s3Bucket (String!)

s3Key (String!)

temporaryUrl (String)

Temporary URL at which the attachment is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page).

Example

{
  "id": "abc123",
  "filename": "abc123",
  "s3Bucket": "abc123",
  "s3Key": "abc123",
  "temporaryUrl": "abc123"
}

Fields

NameDescription

eventType (String!)

id (ID!)

The ID of the object

message (PrintMessageType)

Print message of the print event.

occurredAt (DateTime!)

Example

{
  "id": "abc123",
  "eventType": "abc123",
  "occurredAt": "2020-01-01T00:00:00.000Z",
  "message": PrintMessageType
}

PrintMessageType

Represents a print communication.

Fields

NameDescription

account (AccountType)

attachments ([PrintAttachmentType])

Attachments of the message.

highPriority (Boolean)

Comms that are marked as high priority.

id (ID!)

The ID of the object

templateCode (String!)

Example

{
  "id": "abc123",
  "templateCode": "abc123",
  "account": AccountType,
  "attachments": [PrintAttachmentType],
  "highPriority": true
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([PrintMessageTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": PrintMessageTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

PrintMessageTypeEdge

A Relay edge containing a PrintMessageType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (PrintMessageType)

The item at the end of the edge

Example

{
  "node": PrintMessageType,
  "cursor": "abc123"
}

Fields

NameDescription

availabilityStatus (ProductAvailabilityStatus!)

availableFrom (DateTime!)

availableTo (DateTime)

code (String!)

description (String!)

This will be shown to customers during sign-up

displayName (String!)

This name will be shown to customers during sign-up

endsAt (DateTime)

This is when end-dated products expire

fullName (String!)

hasMinimumTerm (Boolean)

Whether the product has a minimum term (contract binding).

isHidden (Boolean!)

Use this field to temporarily make a product unavailable

isTimeOfUse (Boolean!)

Whether the product is a time of use product.

marketName (String!)

minimumTerm (Int)

The minimum term (contract binding) in months. 0 means no minimum term.

params (JSONString!)

term (Int)

Duration of agreements using this product in months

termsContractType (String!)

Example

{
  "marketName": "abc123",
  "code": "abc123",
  "fullName": "abc123",
  "displayName": "abc123",
  "description": "abc123",
  "availableFrom": "2020-01-01T00:00:00.000Z",
  "availableTo": "2020-01-01T00:00:00.000Z",
  "isHidden": true,
  "term": 1,
  "endsAt": "2020-01-01T00:00:00.000Z",
  "availabilityStatus": "PUBLIC",
  "termsContractType": "abc123",
  "params": {"key": "value"},
  "hasMinimumTerm": true,
  "minimumTerm": 1,
  "isTimeOfUse": true
}

ProductSwitch

Confirm a product switch (self-serve).

The possible errors that can be raised are:

  • KT-DE-4901: Feature is unavailable.
  • KT-DE-4902: Unable to proceed.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

productSwitched (Boolean)

Whether the product switch was successful.

Example

{
  "possibleErrors": [PossibleErrorType],
  "productSwitched": true
}

Fields

NameDescription

administrativeArea (String)

Top-level administrative subdivision, e.g. US state, AU state/territory, IT region, JP prefecture.

AU: Australia

This must be one of NSW, VIC, QLD, TAS, ACT, SA, NT, WA. For addresses not within these locations, use the value that Australia Post uses, e.g. ACT for the Jervis Bay Territory or WA for Christmas Island.

country (String)

ISO 3166-1 alpha-2 code of the country this address belongs to, e.g. AU, GB.

deliveryPointIdentifier (String)

Identifier used by the local postal service for this address, e.g. AU DPID, GB postcode + Delivery Point Suffix, US Zip-9 + Delivery Point.

This is the value that gets encoded in the barcode printed on the envelope by large-volume bulk mail providers.

dependentLocality (String)

UK dependent localities, or neighbourhoods or boroughs in some other locations.

locality (String)

City or town portion of an address, e.g. US city, AU suburb/town, IT comune, UK post town.

name (String)

A personal name.

organization (String)

The name of a business or organisation.

postalCode (String)

Postal code (ZIP code in the US).

sortingCode (String)

Sorting code, e.g. FR CEDEX code. This field is not used in many countries.

streetAddress (String)

The 'street address' component.

This value can (and often will) contain newline characters when appropriate.

In some cases, data may appear in this field instead of the below fields; e.g. a UK post town name may appear here instead of in the dependent_locality field. This happens when data has been migrated from a legacy format, and that format had insufficient metadata to determine the appropriate field.

If structured_street_address is also set, the value of this field will be a string generated from that value.

structuredStreetAddress (GenericScalar)

The 'street address' component, in a structured format.

This field stores the same value as street_address, but with more detail; for instance, instead of 123 Example Street it might be {'street_number': '123', 'street_name': 'Example', 'street_type': 'Street'}. In many cases this will be blank; we only use this field for Krakens where we need to supply this level of granularity to some third-party service, like a bulk mail provider.

The exact structure of this value depends on the country of the address, which is not necessarily the same as the country this Kraken is configured to serve. For addresses outside of the countries listed below, this field will be left blank.

AU: Australia

The following keys may be present; all are optional. All keys have string values, and their meaning is the same as their aseXML counterparts. (Note that, unlike aseXML, all keys are provided at the top level, rather than being nested.)

  • flat_or_unit_type
  • flat_or_unit_number
  • floor_or_level_type
  • floor_or_level_number
  • building_or_property_name
  • location_descriptor
  • lot_number
  • house_number_1
  • house_number_suffix_1
  • house_number_2
  • house_number_suffix_2
  • street_name
  • street_type
  • street_suffix
  • postal_delivery_type
  • postal_delivery_number_prefix
  • postal_delivery_number_value
  • postal_delivery_number_suffix

JP: Japan

The following keys may be present; all are optional. If keys are empty, they may be omitted from the response entirely.

  • chome
  • banchi
  • go
  • edaban
  • kana_building_name
  • kanji_building_name
  • building_number
  • room_number
  • address_code
  • physical_location_identifier

Example

{
  "name": "abc123",
  "organization": "abc123",
  "streetAddress": "abc123",
  "structuredStreetAddress": "abc123" | 1 | 1.0 | true | ["abc123"] | AccountType,
  "dependentLocality": "abc123",
  "locality": "abc123",
  "administrativeArea": "abc123",
  "postalCode": "abc123",
  "sortingCode": "abc123",
  "country": "abc123",
  "deliveryPointIdentifier": "abc123"
}

Fields

NameDescription

property (PropertyType!)

The matched property.

score (Decimal!)

A score representing the degree of confidence for a match.

Example

{
  "score": 1.0,
  "property": PropertyType
}

Fields

NameDescription

address (String)

The address of the property, formatted into a single string.

coordinates (CoordinatesType)

Coordinates for the property, useful for displaying the property on a map.

electricityMalos ([MaLo])

All the electricity supply points at this property.

embeddedNetwork (EmbeddedNetworkType)

The embedded network this property belongs to, if any.

gasMalos ([MaLo])

All the gas supply points at this property.

id (String)

measurements (MeasurementConnection)

Measurements at a property

occupancyPeriods ([OccupancyPeriodType])

Time periods during which the property is associated with an account. Useful to display information about house-moves, as performing a move out of a property will set the end date for the occupancy period.

postcode (String)

The postcode of the property.

richAddress (PropertyRichAddressType)

Property rich address.

splitAddress ([String])

List of address lines.

Example

{
  "id": "abc123",
  "address": "abc123",
  "richAddress": PropertyRichAddressType,
  "splitAddress": ["abc123"],
  "occupancyPeriods": [OccupancyPeriodType],
  "coordinates": CoordinatesType,
  "embeddedNetwork": EmbeddedNetworkType,
  "measurements": MeasurementConnection,
  "postcode": "abc123",
  "electricityMalos": [MaLo],
  "gasMalos": [MaLo]
}

Fields

NameDescription

oauthUri (String!)

OAuth 2.0 URI for the provider.

Example

{
  "oauthUri": "abc123"
}

ProviderVirtualKeyDetailsType

Details of a public key that can be added to devices for end-to-end authentication or encryption.

E.g. for Tesla the user visits a URL and the name can be used to show what the key is called. https://github.com/teslamotors/vehicle-command#distributing-your-public-key

Fields

NameDescription

virtualKeyName (String!)

Friendly human-readable name for the virtual key.

virtualKeyUri (String!)

URI for the virtual key.

Example

{
  "virtualKeyName": "abc123",
  "virtualKeyUri": "abc123"
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([ProvisionalTransactionConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": ProvisionalTransactionConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

ProvisionalTransactionConnectionTypeEdge

A Relay edge containing a ProvisionalTransactionConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (ProvisionalTransactionType)

The item at the end of the edge

Example

{
  "node": ProvisionalTransactionType,
  "cursor": "abc123"
}

ProvisionalTransactionType

A provisional transaction represents some debit or credit to or from a customer's account which we cannot yet finalise for some reason, but which is still useful to keep a note of, and display to the customer. Provisional transactions are purely to give guidance in the absence of finalised information. We therefore only return provisional transactions that have not been finalised. When a transaction is finalised, it is available through the transactions field.

Fields

NameDescription

amount (Int)

The amount in pence for this provisional transaction. It will be negative for charges, positive for credits.

date (Date)

The date at which the charge should be applied to the account.

id (ID!)

title (String)

A user readable string that indicates what this transaction relates to.

Example

{
  "id": "abc123",
  "title": "abc123",
  "amount": 1,
  "date": "2020-01-01"
}

PushNotificationBindingType

Represents a pairing of a single app installation to an account user.

Fields

NameDescription

application (NotifiableApplicationType!)

expiresAt (DateTime!)

id (ID!)

messages (PrintMessageTypeConnection!)

registeredAt (DateTime!)

token (String!)

user (AccountUserType!)

Example

{
  "id": "abc123",
  "messages": PrintMessageTypeConnection,
  "user": AccountUserType,
  "token": "abc123",
  "application": NotifiableApplicationType,
  "registeredAt": "2020-01-01T00:00:00.000Z",
  "expiresAt": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

city (String)

electricityNetworkOperatorId (String)

electricityNetworkOperatorName (String)

electricityNetworkOperatorNumber (String)

gasNetworkOperatorId (String)

gasNetworkOperatorName (String)

gasNetworkOperatorNumber (String)

houseNumber (String)

postcode (String)

street (String)

supplierId (String)

tariffId (String)

Example

{
  "postcode": "abc123",
  "city": "abc123",
  "street": "abc123",
  "houseNumber": "abc123",
  "gasNetworkOperatorNumber": "abc123",
  "gasNetworkOperatorId": "abc123",
  "gasNetworkOperatorName": "abc123",
  "electricityNetworkOperatorNumber": "abc123",
  "electricityNetworkOperatorId": "abc123",
  "electricityNetworkOperatorName": "abc123",
  "supplierId": "abc123",
  "tariffId": "abc123"
}

Fields

NameDescription

clientParams (QuotedProductClientParams)

The client parameters used to generate the quoted product.

id (Int!)

The quoted product ID.

isValidForRetentionProductSwitch (Boolean)

Whether the quoted product is still valid for the (retention) product switch.

product (Product)

The product associated with the quoted product.

retentionNumberOfValidDays (Int)

Number of days the retention offer for the quoted product is valid for.

retentionOfferGenerationDate (Date)

The date the retention offer was generated and sent to the customer.

wasSelected (Boolean)

Whether the quoted product was selected by the user.

Example

{
  "id": 1,
  "product": Product,
  "wasSelected": true,
  "clientParams": QuotedProductClientParams,
  "retentionNumberOfValidDays": 1,
  "retentionOfferGenerationDate": "2020-01-01",
  "isValidForRetentionProductSwitch": true
}

Fields

NameDescription

annualConsumption (Int)

Annual consumption in kWh.

monthlyStandingCharge (Decimal)

Monthly standing charge in €.

netMonthlyStandingCharge (Decimal)

Net monthly standing charge in €.

netUnitRatePerKwh (Decimal)

Net unit rate per kWh in €.

totalEstimatedAnnualBill (Decimal)

Total estimated annual bill in €.

unitRatePerKwh (Decimal)

Unit rate per kWh in €.

Example

{
  "annualConsumption": 1,
  "monthlyStandingCharge": 1.0,
  "netMonthlyStandingCharge": 1.0,
  "unitRatePerKwh": 1.0,
  "netUnitRatePerKwh": 1.0,
  "totalEstimatedAnnualBill": 1.0
}

Fields

NameDescription

limit (Int)

The maximum number of points the viewer gets for requests per hour.

remainingPoints (Int)

The remaining points for the viewer in one hour time limit.

usedPoints (Int)

The points used so far in one hour time limit.

Example

{
  "limit": 1,
  "remainingPoints": 1,
  "usedPoints": 1
}

ReauthenticateDevice

Re-authenticate a device. The authentication details provided must be for the same device as was previously authenticated.

The possible errors that can be raised are:

  • KT-CT-4313: Could not find KrakenFlex device.
  • KT-CT-4314: Unable to get provider details.
  • KT-CT-4315: Unable to re-authenticate device.
  • KT-CT-4363: No capable devices found.
  • KT-CT-4364: Multiple devices found.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

Fields

NameDescription

buttonAction (ActionType!)

The action to perform when the button is pressed.

buttonStyle (ButtonStyle)

The button style.

id (ID)

Unique identifier of the object.

title (String!)

Title text of the button.

typename (String)

The name of the object's type.

variant (ButtonVariance)

Colour style of button eg. filled, outlined, text_only.

Example

{
  "buttonStyle": "PRIMARY",
  "title": "abc123",
  "buttonAction": DeeplinkActionType,
  "id": "abc123",
  "typename": "abc123",
  "variant": "FILLED"
}

RedeemLoyaltyPointsForAccountCredit

Redeem Loyalty Points as account credit.

The possible errors that can be raised are:

  • KT-CT-1111: Unauthorized.
  • KT-CT-9201: No Loyalty Point ledger found for the user.
  • KT-CT-9202: Loyalty Points adapter not configured.
  • KT-CT-9203: No ledger entries for the ledger.
  • KT-CT-9205: Insufficient Loyalty Points.
  • KT-CT-9206: Indivisible points.
  • KT-CT-9204: Negative or zero points set.
  • KT-CT-9208: Invalid posted at datetime.
  • KT-CT-9209: Negative Loyalty Points balance.
  • KT-CT-9210: Unhandled Loyalty Points exception.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

pointsRedeemed (Int)

The number of OctoPoints that were redeemed.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "pointsRedeemed": 1
}

RedeemReferralClaimCode

The possible errors that can be raised are:

  • KT-CT-6723: Unauthorized.
  • KT-CT-6724: Referral claim code not found.
  • KT-CT-6725: Referral claim code redeeming error.
  • KT-CT-6726: Referral claim code has already been redeemed.
  • KT-CT-6727: Referral claim code is not available.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType]
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([ReferralConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": ReferralConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

ReferralConnectionTypeEdge

A Relay edge containing a ReferralConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (ReferralType)

The item at the end of the edge

Example

{
  "node": ReferralType,
  "cursor": "abc123"
}

ReferralSchemeType

A referral scheme is a way for one account to earn a reward for referring another. This is achieved by the referred account using a url (provided by the referring account) to sign up.

Fields

NameDescription

canBeReferred (Boolean)

Whether the current account is eligible to be referred under this scheme.

code (String)

The unique code for the scheme.

combinedRewardAmount (Int)

The reward amount received by the referrer and the referee combined.

loyaltyPointsBonus (Int)

The number of loyalty points to be awarded to the referrer in addition to the reward amount.

referralDisplayUrl (String)

A referral url for display purposes.

referralUrl (String)

A fully qualified url give people to create accounts referred by this scheme.

referredRewardAmount (Int)

The reward amount received by the referred party.

referrerFamilyName (String)

The family name of the person making the referral.

Deprecated

The 'referringFamilyName' field is deprecated.

Only make use of the referrerGivenName for privacy reasons.

- Marked as deprecated on 2022-11-07.
- Will be removed on 2023-01-07.

referrerGivenName (String)

The given name of the person making the referral.

referrerRewardAmount (Int)

The reward amount received by the referrer.

schemeType (String)

Scheme type of the referral scheme.

Example

{
  "referralUrl": "abc123",
  "referralDisplayUrl": "abc123",
  "referrerRewardAmount": 1,
  "referredRewardAmount": 1,
  "combinedRewardAmount": 1,
  "loyaltyPointsBonus": 1,
  "canBeReferred": true,
  "code": "abc123",
  "referrerGivenName": "abc123",
  "referrerFamilyName": "abc123",
  "schemeType": "abc123"
}

Fields

NameDescription

business (ReferralSchemeType)

domestic (ReferralSchemeType)

friendsAndFamily (ReferralSchemeType)

Deprecated

The 'friendsAndFamily' field is deprecated.

Please use domestic instead.

- Marked as deprecated on 2020-03-05.
- Will be removed on 2024-01-01.

Example

{
  "domestic": ReferralSchemeType,
  "business": ReferralSchemeType,
  "friendsAndFamily": ReferralSchemeType
}

ReferralType

Details of an account referral

Fields

NameDescription

code (String)

combinedPaymentAmount (Int)

The payment amount in cents received by the referrer and the referee combined.

id (ID!)

ledgerId (Int)

The ID of the ledger which the referral is assigned to.

paymentDate (Date)

paymentStatus (String)

referredUserJoinDate (DateTime)

referredUserName (String)

referredUserPaymentAmount (Int)

Payment amount given to the referred account in cents.

referringUserPaymentAmount (Int)

Payment amount given to the referring account in cents.

schemeType (ReferralSchemeTypeChoices)

The type of reward scheme.

Example

{
  "id": "abc123",
  "ledgerId": 1,
  "paymentDate": "2020-01-01",
  "schemeType": "REFERRAL_REWARD",
  "referredUserName": "abc123",
  "paymentStatus": "abc123",
  "referredUserJoinDate": "2020-01-01T00:00:00.000Z",
  "code": "abc123",
  "referredUserPaymentAmount": 1,
  "referringUserPaymentAmount": 1,
  "combinedPaymentAmount": 1
}

Refund

A refund to the customer from the energy supplier.

Fields

NameDescription

accountNumber (String)

Unique identifier of the account the transaction belongs to.

amount (Int)

Gross amount including tax (when payable). Refer to the amounts field for a breakdown of this information.

Deprecated

The 'amount' field is deprecated.

Use `amounts` instead for a breakdown of the relevant net, tax, and gross amounts.

- Marked as deprecated on 2023-12-06.
- Will be removed on 2024-06-01.

amounts (TransactionAmountType)

The net, tax and gross amounts for the transaction. Note: for payments and repayments, only the net amount is returned.

balanceCarriedForward (Int)

The customer's resulting balance after this transaction has been applied, in the smallest unit of currency.

billingDocumentIdentifier (ID)

The unique identifier for the most recent billing document linked with the transaction.Note: a transaction may be linked with multiple documents, but this field will only return the identifier for the most recent billing document.

createdAt (DateTime)

The date time when the transaction is created.

hasStatement (Boolean)

Returns True if the transaction is linked with a statement.

id (ID)

isAccountCharge (Boolean)

Deprecated.

Deprecated

The 'isAccountCharge' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isAccountPayment (Boolean)

Deprecated.

Deprecated

The 'isAccountPayment' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isCredit (Boolean)

Deprecated.

Deprecated

The 'isCredit' field is deprecated.

This information is provided by the __typename introspection query.

- Marked as deprecated on 2020-06-19.
- Will be removed on 2022-11-15.

isHeld (Boolean)

Whether the statement this transaction is on has been held. A held statement is not sent to a customer automatically, but is instead marked for manual attention by operations staff. Returns False if a statement is not linked with the transaction.

isIssued (Boolean)

Whether this transaction has been issued on any billing document.Note: Look for the most recently issued transaction instead of looking through all transactions as some accounts may have initial transactions that were not issued.This will return False if the transaction is not associated with any billing documents.

isReversed (Boolean!)

note (String)

Returns the note field value for the transaction, which contains additional info.

postedDate (Date)

statementId (ID)

Returns None if a statement is not linked with the transaction.

Deprecated

The 'statementId' field is deprecated.

Use `billingDocumentIdentifier` instead.

- Marked as deprecated on 2023-11-30.
- Will be removed on 2024-06-01.

title (String)

Example

{
  "id": "abc123",
  "postedDate": "2020-01-01",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "accountNumber": "abc123",
  "amount": 1,
  "amounts": TransactionAmountType,
  "balanceCarriedForward": 1,
  "isCredit": true,
  "isAccountCharge": true,
  "isAccountPayment": true,
  "isHeld": true,
  "isIssued": true,
  "title": "abc123",
  "billingDocumentIdentifier": "abc123",
  "statementId": "abc123",
  "isReversed": true,
  "hasStatement": true,
  "note": "abc123"
}

Fields

NameDescription

amount (Int)

The amount of money requested.

payment (AccountPaymentType)

The payment which is being refunded.

reasonCode (String)

Internal code for the reason the refund is being requested.

requestId (ID)

The ID of the refund request.

status (RepaymentRequestStatus)

The current status of the refund request.

Example

{
  "requestId": "abc123",
  "amount": 1,
  "payment": AccountPaymentType,
  "reasonCode": "abc123",
  "status": "REQUESTED"
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([RefundRequestConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": RefundRequestConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

RefundRequestConnectionTypeEdge

A Relay edge containing a RefundRequestConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (RefundPaymentRequestType)

The item at the end of the edge

Example

{
  "node": RefundPaymentRequestType,
  "cursor": "abc123"
}

RegenerateSecretKey

Regenerate the user's live secret key.

Fields

NameDescription

viewer (AccountUserType)

The currently authenticated user.

This field requires the Authorization header to be set.

Example

{
  "viewer": AccountUserType
}

Fields

NameDescription

pushNotificationBinding (PushNotificationBindingType)

Example

{
  "pushNotificationBinding": PushNotificationBindingType
}

RegisterReadingConnectionTypeConnection

This field is a connection type. Connections are used to implement cursor based pagination.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([RegisterReadingConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": RegisterReadingConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

RegisterReadingConnectionTypeEdge

A Relay edge containing a RegisterReadingConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (BaseRegisterReadingType)

The item at the end of the edge

Example

{
  "node": BaseRegisterReadingType,
  "cursor": "abc123"
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([RepaymentRequestConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": RepaymentRequestConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

RepaymentRequestConnectionTypeEdge

A Relay edge containing a RepaymentRequestConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (RepaymentRequestType)

The item at the end of the edge

Example

{
  "node": RepaymentRequestType,
  "cursor": "abc123"
}

Fields

NameDescription

amount (Int)

The amount of money requested.

instruction (PaymentInstructionType)

The payment instruction, if any, associated with the repayment request.

method (RepaymentMethod)

The method by which the money will be transferred to the customer.

reasonCode (String)

Classifier code for repayment reason.

requestId (String)

The ID of the repayment request.

status (RepaymentRequestStatus)

The current status of the repayment request.

Example

{
  "requestId": "abc123",
  "amount": 1,
  "reasonCode": "abc123",
  "method": "BANK_TRANSFER",
  "instruction": PaymentInstructionType,
  "status": "REQUESTED"
}

Fields

NameDescription

email (String)

The email that requested a password reset email.

Example

{
  "email": "abc123"
}

Fields

NameDescription

canRequestRefund (Boolean!)

Whether the account can request a refund.

reason (String)

The reason why a refund cannot be requested.

Example

{
  "canRequestRefund": true,
  "reason": "abc123"
}

RequestRepaymentOutputType

Output for creating a repayment request.

Fields

NameDescription

requestId (String)

The ID of the repayment request.

status (RepaymentRequestStatus)

The current status of the repayment request.

Example

{
  "requestId": "abc123",
  "status": "REQUESTED"
}

Fields

NameDescription

clientMutationId (String)

errors ([SerializerFieldErrorsType])

Example

{
  "errors": [SerializerFieldErrorsType],
  "clientMutationId": "abc123"
}

Fields

NameDescription

failureReasons ([String])

A list of which password validations the new password failed against if applicable.

passwordUpdated (Boolean)

True if the password update was successful, false otherwise.

Example

{
  "passwordUpdated": true,
  "failureReasons": ["abc123"]
}

ResumeDeviceControl

Resume control of a device after having been away from home.

This is so that the device can be charged again according to the set preferences.

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4359: Unable to resume device control.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

RevokeContract

Revoke a contract for a given supply point and send confirmation email to the customer.

The possible errors that can be raised are:

  • KT-CT-4923: Unauthorized.
  • KT-CT-4922: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

contractRevoked (Boolean)

Whether the contract revocation was successful.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "contractRevoked": true
}

RewardType

        A reward is based on a scheme that an account has applied for in order to be
        eligible for a discount. Examples can include signup, promo, or partner codes that
        were applied to an account.

Fields

NameDescription

id (ID!)

ledgerId (Int)

The ID of the ledger which the referral is assigned to.

paymentDate (Date)

paymentStatus (ReferralStatusChoices)

The status of the reward payment.

rewardAmount (Int)

Reward amount given to the account in cents.

schemeType (ReferralSchemeTypeChoices)

The type of reward scheme.

Example

{
  "id": "abc123",
  "ledgerId": 1,
  "paymentDate": "2020-01-01",
  "schemeType": "REFERRAL_REWARD",
  "rewardAmount": 1,
  "paymentStatus": "Pending"
}

RichAddressType

A postal address.

This data model is based on the structure used by Google's libaddressinput library—so you can use it, or other libraries that use its data model and reference data, to accept input.

All fields can be blank, except for country which must always be supplied.

Fields

NameDescription

administrativeArea (String)

Top-level administrative subdivision, e.g. US state, AU state/territory, IT region, JP prefecture.

AU: Australia

This must be one of NSW, VIC, QLD, TAS, ACT, SA, NT, WA. For addresses not within these locations, use the value that Australia Post uses, e.g. ACT for the Jervis Bay Territory or WA for Christmas Island.

country (String)

ISO 3166-1 alpha-2 code of the country this address belongs to, e.g. AU, GB.

deliveryPointIdentifier (String)

Identifier used by the local postal service for this address, e.g. AU DPID, GB postcode + Delivery Point Suffix, US Zip-9 + Delivery Point.

This is the value that gets encoded in the barcode printed on the envelope by large-volume bulk mail providers.

dependentLocality (String)

UK dependent localities, or neighbourhoods or boroughs in some other locations.

locality (String)

City or town portion of an address, e.g. US city, AU suburb/town, IT comune, UK post town.

name (String)

A personal name.

organization (String)

The name of a business or organisation.

postalCode (String)

Postal code (ZIP code in the US).

sortingCode (String)

Sorting code, e.g. FR CEDEX code. This field is not used in many countries.

streetAddress (String)

The 'street address' component.

This value can (and often will) contain newline characters when appropriate.

In some cases, data may appear in this field instead of the below fields; e.g. a UK post town name may appear here instead of in the dependent_locality field. This happens when data has been migrated from a legacy format, and that format had insufficient metadata to determine the appropriate field.

If structured_street_address is also set, the value of this field will be a string generated from that value.

structuredStreetAddress (GenericScalar)

The 'street address' component, in a structured format.

This field stores the same value as street_address, but with more detail; for instance, instead of 123 Example Street it might be {'street_number': '123', 'street_name': 'Example', 'street_type': 'Street'}. In many cases this will be blank; we only use this field for Krakens where we need to supply this level of granularity to some third-party service, like a bulk mail provider.

The exact structure of this value depends on the country of the address, which is not necessarily the same as the country this Kraken is configured to serve. For addresses outside of the countries listed below, this field will be left blank.

AU: Australia

The following keys may be present; all are optional. All keys have string values, and their meaning is the same as their aseXML counterparts. (Note that, unlike aseXML, all keys are provided at the top level, rather than being nested.)

  • flat_or_unit_type
  • flat_or_unit_number
  • floor_or_level_type
  • floor_or_level_number
  • building_or_property_name
  • location_descriptor
  • lot_number
  • house_number_1
  • house_number_suffix_1
  • house_number_2
  • house_number_suffix_2
  • street_name
  • street_type
  • street_suffix
  • postal_delivery_type
  • postal_delivery_number_prefix
  • postal_delivery_number_value
  • postal_delivery_number_suffix

JP: Japan

The following keys may be present; all are optional. If keys are empty, they may be omitted from the response entirely.

  • chome
  • banchi
  • go
  • edaban
  • kana_building_name
  • kanji_building_name
  • building_number
  • room_number
  • address_code
  • physical_location_identifier

Example

{
  "name": "abc123",
  "organization": "abc123",
  "streetAddress": "abc123",
  "structuredStreetAddress": "abc123" | 1 | 1.0 | true | ["abc123"] | AccountType,
  "dependentLocality": "abc123",
  "locality": "abc123",
  "administrativeArea": "abc123",
  "postalCode": "abc123",
  "sortingCode": "abc123",
  "country": "abc123",
  "deliveryPointIdentifier": "abc123"
}

ScheduleQuoteFollowUp

Schedule a quote follow up message to the provided recipient.

The possible errors that can be raised are:

  • KT-CT-4619: Quote with given code not found.
  • KT-CT-4632: Invalid recipient information.
  • KT-CT-4633: Mutation not enabled in this environment.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

success (Boolean!)

Whether the message was scheduled successfully.

Example

{
  "possibleErrors": [PossibleErrorType],
  "success": true
}

ScreenActionType

An action which calls another backend screen via its screen id.

Fields

NameDescription

allowBack (Boolean!)

Whether to allow returning to the original caller screen.

id (ID)

Unique identifier of the object.

params ([BackendScreenParam]!)

Map of the parameters (key-value pairs) to pass to the next backend screen.

screenId (String!)

The ID of the screen to navigate to.

typeName (String)

The name of the action object's type.

typename (String)

The name of the object's type.

Example

{
  "id": "abc123",
  "typename": "abc123",
  "typeName": "abc123",
  "screenId": "abc123",
  "params": BackendScreenParam,
  "allowBack": true
}

SectionType

A section containing a list of cards or carousel items

Fields

NameDescription

content (SectionContent!)

The content of the section.

id (ID)

Unique identifier of the object.

order (Int!)

The order of the section.

typename (String)

The name of the object's type.

Example

{
  "id": "abc123",
  "typename": "abc123",
  "content": CardComponentType,
  "order": 1
}

SelectChargePointMake

Options for selecting a charge point's make from a list of options.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

options ([SmartFlexListItemInterface])

The options the user can select.

selectedOptionId (ID)

The ID of the option that has been selected, if any.

Example

{
  "id": "abc123",
  "options": SmartFlexListItemInterface,
  "selectedOptionId": "abc123"
}

SelectChargePointMakeForSmartFlexOnboarding

Complete the select charge point make step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

chargePointMake (ChargePointVariantType)

The make of the charge point, e.g. myenergi.

id (ID)

A unique identifier for this list item.

Example

{
  "id": "abc123",
  "chargePointMake": ChargePointVariantType
}

SelectChargePointVariant

Options for selecting a charge point's variant from a list of options.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

options ([SmartFlexListItemInterface])

The options the user can select.

selectedOptionId (ID)

The ID of the option that has been selected, if any.

Example

{
  "id": "abc123",
  "options": SmartFlexListItemInterface,
  "selectedOptionId": "abc123"
}

SelectChargePointVariantForSmartFlexOnboarding

Complete the select charge point variant step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

chargePointVariant (ChargePointVariantType)

The model variant of the charge point, e.g. Zappi.

id (ID)

A unique identifier for this list item.

Example

{
  "id": "abc123",
  "chargePointVariant": ChargePointVariantType
}

SelectDeviceType

A type where the user must select the type of device to onboard.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

options ([SmartFlexListItemInterface])

The options the user can select.

selectedOptionId (ID)

The ID of the option that has been selected, if any.

Example

{
  "id": "abc123",
  "options": SmartFlexListItemInterface,
  "selectedOptionId": "abc123"
}

SelectDeviceTypeForSmartFlexOnboarding

Select the type of device to start the onboarding process.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

id (ID)

A unique identifier for this list item.

label (String)

The device type, e.g. Electric Vehicle.

Example

{
  "id": "abc123",
  "label": "abc123"
}

SelectUserVehicle

Options for selecting a user's vehicle from a list of options.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

options ([SmartFlexListItemInterface])

The options the user can select.

selectedOptionId (ID)

The ID of the option that has been selected, if any.

Example

{
  "id": "abc123",
  "options": SmartFlexListItemInterface,
  "selectedOptionId": "abc123"
}

SelectUserVehicleForSmartFlexOnboarding

Complete the select user vehicle step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

id (ID)

A unique identifier for this list item.

userVehicle (ElectricVehicleType)

The selected electric vehicle when multiple vehicles were available.

Example

{
  "id": "abc123",
  "userVehicle": ElectricVehicleType
}

SelectVehicleMake

Options for selecting a vehicle's make from a list of options.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

options ([SmartFlexListItemInterface])

The options the user can select.

selectedOptionId (ID)

The ID of the option that has been selected, if any.

Example

{
  "id": "abc123",
  "options": SmartFlexListItemInterface,
  "selectedOptionId": "abc123"
}

SelectVehicleMakeForSmartFlexOnboarding

Complete the select vehicle make step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

id (ID)

A unique identifier for this list item.

vehicleMake (ElectricVehicleType)

The make of the electric vehicle make, e.g. Tesla.

Example

{
  "id": "abc123",
  "vehicleMake": ElectricVehicleType
}

SelectVehicleVariant

Options for selecting a vehicle's variant from a list of options.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

options ([SmartFlexListItemInterface])

The options the user can select.

selectedOptionId (ID)

The ID of the option that has been selected, if any.

Example

{
  "id": "abc123",
  "options": SmartFlexListItemInterface,
  "selectedOptionId": "abc123"
}

SelectVehicleVariantForSmartFlexOnboarding

Complete the select vehicle variant step.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

id (ID)

A unique identifier for this list item.

vehicleVariant (ElectricVehicleType)

The model variant of the electric vehicle, e.g. Model Y.

Example

{
  "id": "abc123",
  "vehicleVariant": ElectricVehicleType
}

SendQuoteSummary

Trigger the sending of a quote summary to the provided recipient.

The possible errors that can be raised are:

  • KT-CT-4619: Quote with given code not found.
  • KT-CT-4632: Invalid recipient information.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

success (Boolean!)

Whether the triggering of the quote summary was successful.

Example

{
  "possibleErrors": [PossibleErrorType],
  "success": true
}

Fields

NameDescription

code (String)

message (String)

Example

{
  "message": "abc123",
  "code": "abc123"
}

Fields

NameDescription

errors ([ErrorTypeUnion!])

field (String)

Example

{
  "field": "abc123",
  "errors": SerializerErrorType
}

SetLoyaltyPointsUser

Set the Loyalty Points user for the account.

The possible errors that can be raised are:

  • KT-CT-1111: Unauthorized.
  • KT-CT-1111: Unauthorized.
  • KT-CT-9210: Unhandled Loyalty Points exception.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

newLoyaltyPointsUserId (String)

ID of the new Loyalty Points user.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "newLoyaltyPointsUserId": "abc123"
}

SetUpDirectDebitInstruction

The possible errors that can be raised are:

  • KT-CT-3940: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

paymentInstruction (DirectDebitInstructionType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "paymentInstruction": DirectDebitInstructionType
}

SetVehicleChargingPreferences

Allow customers to set/update their vehicle's charging preferences.

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4321: Serializer validation error.
  • KT-CT-4353: An error occurred while trying to update your charging preferences.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

ShareGoodsQuote

The possible errors that can be raised are:

  • KT-CT-4122: Invalid email.
  • KT-CT-8203: Received an invalid quote code.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

share (GoodsQuoteShare)

Goods quote shared.

Example

{
  "possibleErrors": [PossibleErrorType],
  "share": GoodsQuoteShare
}

Fields

NameDescription

grossRateInformation ([GrossRateInformation]!)

A list of gross rate information.

latestGrossUnitRateCentsPerKwh (Decimal!)

The latest value of the gross unit rate, in ct/kWh.

netUnitRateCentsPerKwh (Decimal!)

The net unit rate, in ct/kWh.

Example

{
  "netUnitRateCentsPerKwh": 1.0,
  "latestGrossUnitRateCentsPerKwh": 1.0,
  "grossRateInformation": GrossRateInformation
}

SmartFlexChargePoint

Information about a charge point that has been registered with Kraken Flex.

Fields

NameDescription

alerts ([SmartFlexDeviceAlertInterface])

Active alert message(s) for a device, showing the latest first.

chargingPreferences (SmartFlexVehicleChargingPreferences)

The user's preferences for charging using this charge point.

deviceType (KrakenFlexDeviceTypes!)

The type of device.

id (ID!)

A UUID that identifies this device registration. Re-registering this device will result in a different ID.

make (String)

The make of the charge point, e.g. myenergi.

model (String)

The model of the charge point, e.g. Zappi.

name (String)

The user-friendly name for the device.

onboardingWizard (SmartFlexOnboardingWizard)

The current onboarding wizard for a device.

preferences (SmartFlexDevicePreferencesInterface)

The device's preference details.

provider (ProviderChoices!)

The third-party that enables control of this device.

status (SmartFlexDeviceStatusInterface)

Information about the current status of this device.

Example

{
  "id": "abc123",
  "name": "abc123",
  "deviceType": "BATTERIES",
  "provider": "DAIKIN",
  "status": SmartFlexDeviceStatusInterface,
  "alerts": SmartFlexDeviceAlertInterface,
  "onboardingWizard": SmartFlexOnboardingWizard,
  "preferences": SmartFlexDevicePreferencesInterface,
  "make": "abc123",
  "model": "abc123",
  "chargingPreferences": SmartFlexVehicleChargingPreferences
}

SmartFlexChargePointStatus

The current status of a registered charge point.

Fields

NameDescription

current (SmartFlexDeviceLifecycleStatus)

The current status of the device.

currentState (SmartFlexDeviceState)

The current state of this SmartFlex device state machine.

isSuspended (Boolean)

Whether control of the device is currently disabled.

stateOfChargeLimit (StateOfChargeLimit)

Information about the limits for the SoC.

testDispatchFailureReason (TestDispatchAssessmentFailureReason)

The reason for the most recent failed test dispatch (if any).

Example

{
  "current": "ONBOARDING",
  "isSuspended": true,
  "currentState": "AUTHENTICATION_PENDING",
  "stateOfChargeLimit": StateOfChargeLimit,
  "testDispatchFailureReason": "NONE"
}

SmartFlexDevice

Information about a device that has been registered for Smart Flex.

Fields

NameDescription

alerts ([SmartFlexDeviceAlertInterface])

Active alert message(s) for a device, showing the latest first.

deviceType (KrakenFlexDeviceTypes!)

The type of device.

id (ID!)

A UUID that identifies this device registration. Re-registering this device will result in a different ID.

name (String)

The user-friendly name for the device.

onboardingWizard (SmartFlexOnboardingWizard)

The current onboarding wizard for a device.

preferences (SmartFlexDevicePreferencesInterface)

The device's preference details.

provider (ProviderChoices!)

The third-party that enables control of this device.

status (SmartFlexDeviceStatusInterface)

Information about the current status of this device.

Example

{
  "id": "abc123",
  "name": "abc123",
  "deviceType": "BATTERIES",
  "provider": "DAIKIN",
  "status": SmartFlexDeviceStatusInterface,
  "alerts": SmartFlexDeviceAlertInterface,
  "onboardingWizard": SmartFlexOnboardingWizard,
  "preferences": SmartFlexDevicePreferencesInterface
}

SmartFlexDeviceAlert

Information about an alert relevant to a device registered for Smart Flex.

Fields

NameDescription

message (String)

A device alert message.

publishedAt (DateTime)

When a device alert message is published.

Example

{
  "message": "abc123",
  "publishedAt": "2020-01-01T00:00:00.000Z"
}

Fields

NameDescription

dayOfWeek (DayOfWeek)

Day of week schedule applies to.

max (Float)

Maximum value set for the schedule.

min (Float)

Minimum value set for the schedule.

time (Time)

Time of day the preference applies.

Example

{
  "dayOfWeek": "MONDAY",
  "time": "00:00:00.000Z",
  "min": 1.0,
  "max": 1.0
}

Fields

NameDescription

mode (PreferencesModeChoices)

The device's preference mode.

schedules ([SmartFlexDevicePreferenceSchedule])

The schedules of the device's preference.

targetType (PreferencesTargetType)

The target type of the preference.

unit (PreferencesUnitChoices)

The unit of the preference schedules' min and max values.

Example

{
  "targetType": "ABSOLUTE_STATE_OF_CHARGE",
  "unit": "CELSIUS",
  "mode": "CHARGE",
  "schedules": [SmartFlexDevicePreferenceSchedule]
}

SmartFlexDeviceStatus

Information about the current status of a device registered for Smart Flex.

Fields

NameDescription

current (SmartFlexDeviceLifecycleStatus)

The current status of the device.

currentState (SmartFlexDeviceState)

The current state of this SmartFlex device state machine.

isSuspended (Boolean)

Whether control of the device is currently disabled.

Example

{
  "current": "ONBOARDING",
  "isSuspended": true,
  "currentState": "AUTHENTICATION_PENDING"
}

SmartFlexOnboardingDeviceRegistration

A type that returns True if the device(s) were successfully registered.

Fields

NameDescription

deviceRegistered (Boolean)

Returns true if the device(s) were successfully registered.

id (ID)

A unique identifier for this onboarding step.

Example

{
  "id": "abc123",
  "deviceRegistered": true
}

Fields

NameDescription

backendScreen (BackendScreenType)

A Backend Screen that renders the SmartFlex onboarding wizard.

completedSteps ([SmartFlexOnboardingStepInterface])

The steps that have been completed in the onboarding journey so far.

currentStep (SmartFlexOnboardingStepInterface)

The next step of the SmartFlex onboarding wizard. Returns None if the onboarding journey is completed.

id (ID!)

A unique identifier for this SmartFlex onboarding wizard.

Example

{
  "id": "abc123",
  "backendScreen": ComponentListType,
  "currentStep": SmartFlexOnboardingStepInterface,
  "completedSteps": SmartFlexOnboardingStepInterface
}

SmartFlexVehicle

Information about a vehicle that has been registered with Kraken Flex.

Fields

NameDescription

alerts ([SmartFlexDeviceAlertInterface])

Active alert message(s) for a device, showing the latest first.

chargingPreferences (SmartFlexVehicleChargingPreferences)

The user's preferences for charging this vehicle.

deviceType (KrakenFlexDeviceTypes!)

The type of device.

id (ID!)

A UUID that identifies this device registration. Re-registering this device will result in a different ID.

make (String)

The make of the vehicle, e.g. Tesla.

model (String)

The model of the vehicle, e.g. Model 3.

name (String)

The user-friendly name for the device.

onboardingWizard (SmartFlexOnboardingWizard)

The current onboarding wizard for a device.

preferences (SmartFlexDevicePreferencesInterface)

The device's preference details.

provider (ProviderChoices!)

The third-party that enables control of this device.

status (SmartFlexDeviceStatusInterface)

Information about the current status of this device.

Example

{
  "id": "abc123",
  "name": "abc123",
  "deviceType": "BATTERIES",
  "provider": "DAIKIN",
  "status": SmartFlexDeviceStatusInterface,
  "alerts": SmartFlexDeviceAlertInterface,
  "onboardingWizard": SmartFlexOnboardingWizard,
  "preferences": SmartFlexDevicePreferencesInterface,
  "make": "abc123",
  "model": "abc123",
  "chargingPreferences": SmartFlexVehicleChargingPreferences
}

SmartFlexVehicleChargingPreferences

The user's preferences for charging, e.g. target SoC (State of Charge).

Fields

NameDescription

maximumSoc (Int)

The maximum SoC (percentage).

minimumSoc (Int)

The minimum SoC (percentage).

weekdayTargetSoc (Int!)

The target SoC to achieve on a weekday (percentage).

weekdayTargetTime (Time!)

The time at which the target SoC should be achieved on a weekday.

weekendTargetSoc (Int!)

The target SoC to achieve on a weekend (percentage).

weekendTargetTime (Time!)

The time at which the target SoC should be achieved on a weekend.

Example

{
  "weekdayTargetTime": "00:00:00.000Z",
  "weekdayTargetSoc": 1,
  "weekendTargetTime": "00:00:00.000Z",
  "weekendTargetSoc": 1,
  "minimumSoc": 1,
  "maximumSoc": 1
}

SmartFlexVehicleStatus

The current status of a registered vehicle.

Fields

NameDescription

current (SmartFlexDeviceLifecycleStatus)

The current status of the device.

currentState (SmartFlexDeviceState)

The current state of this SmartFlex device state machine.

isSuspended (Boolean)

Whether control of the device is currently disabled.

stateOfChargeLimit (StateOfChargeLimit)

Information about the limits for the SoC.

testDispatchFailureReason (TestDispatchAssessmentFailureReason)

The reason for the most recent failed test dispatch (if any).

Example

{
  "current": "ONBOARDING",
  "isSuspended": true,
  "currentState": "AUTHENTICATION_PENDING",
  "stateOfChargeLimit": StateOfChargeLimit,
  "testDispatchFailureReason": "NONE"
}

SpecialCancelContract

Perform special cancellation for a given supply point and send confirmation email to the customer.

The possible errors that can be raised are:

  • KT-CT-4923: Unauthorized.
  • KT-CT-4922: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

cancelledContract (Boolean)

Whether the special contract cancellation was successful.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "cancelledContract": true
}

SpecialCircumstanceRecordType

Any special circumstances that the user has notified us about, which may entitle them to some specialist services.

Fields

NameDescription

id (ID)

internalCode (String)

summary (String)

Example

{
  "id": "abc123",
  "summary": "abc123",
  "internalCode": "abc123"
}

SpecialCircumstancesType

Information about the special circumstances that relate to a user.

Fields

NameDescription

isSharingConsentGiven (Boolean)

Whether the user has consented for their data to be given to the appropriate industry or regulatory bodies. We typically only ask for this once, so this field can be used to decide whether to ask the user for their initial consent.

records ([SpecialCircumstanceRecordUnion])

Example

{
  "isSharingConsentGiven": true,
  "records": SpecialCircumstanceRecordType
}

SpinWheelOfFortune

The possible errors that can be raised are:

  • KT-CT-7011: Terms must be accepted.
  • KT-CT-7023: Unauthorized.
  • KT-CT-7010: The account does not have any available submissions.
  • KT-CT-7012: Wheel of Fortune submission error.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

spinResult (WheelOfFortuneSpinResultType)

The result of the Wheel of Fortune spin.

This field requires the Authorization header to be set.

Example

{
  "possibleErrors": [PossibleErrorType],
  "spinResult": WheelOfFortuneSpinResultType
}

StartSmartFlexOnboarding

Create a wizard for onboarding a device with SmartFlex.

The possible errors that can be raised are:

  • KT-CT-4321: Serializer validation error.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

StartTestChargeForSmartFlexOnboarding

Attempt to start a test charge.

The possible errors that can be raised are:

  • KT-CT-4371: Onboarding wizard ID is invalid.
  • KT-CT-4372: Simultaneous attempts to update onboarding process.
  • KT-CT-4375: Incorrect or missing parameters for SmartFlex onboarding step.
  • KT-CT-4376: Unable to complete onboarding step. Please try agan later.
  • KT-CT-4377: Invalid onboarding step ID.
  • KT-CT-4378: Invalid input or step id. Please make sure you are using the correct step id and providing the expected input params.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

wizard (SmartFlexOnboardingWizard)

The wizard created for onboarding the device with SmartFlex.

Example

{
  "possibleErrors": [PossibleErrorType],
  "wizard": SmartFlexOnboardingWizard
}

Fields

NameDescription

isLimitViolated (Boolean)

Whether or not target SoC exceeds upper SoC limit.

timestamp (String)

Time of the latest SoC limit reading.

upperSocLimit (Int)

Maximum level of charge allowed by the battery relative to its capacity (in percent).

Example

{
  "upperSocLimit": 1,
  "timestamp": "abc123",
  "isLimitViolated": true
}

StatementBillingDocumentConnectionTypeConnection

A statement is a billing document that contains all entries on a ledger during a period of time. A customer can understand how their ledger's balance has changed by looking at each statement in series.

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([StatementBillingDocumentConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": StatementBillingDocumentConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

StatementBillingDocumentConnectionTypeEdge

A Relay edge containing a StatementBillingDocumentConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (StatementBillingDocumentType)

The item at the end of the edge

Example

{
  "node": StatementBillingDocumentType,
  "cursor": "abc123"
}

StatementBillingDocumentType

A statement is a billing document that contains all entries on a ledger during a period of time. A customer can understand how their ledger's balance has changed by looking at each statement in series.

Fields

NameDescription

annulledBy (AnnulmentBillingDocumentType)

Billing document that annuls this statement.

earliestChargeAt (DateTime)

The earliest charge date of the statement.

endAt (DateTime!)

The end of the statement's period.

firstIssuedAt (DateTime)

The date and time the statement was sent to the customer.

id (Int)

identifier (String)

The unique reference of the statement that can be used for identifying the statement externally.

latestChargeAt (DateTime)

The latest charge date of the statement.

pdfUrl (String)

URL to the PDF of the statement.

startAt (DateTime!)

The start of the statement's period.

Example

{
  "id": 1,
  "identifier": "abc123",
  "startAt": "2020-01-01T00:00:00.000Z",
  "endAt": "2020-01-01T00:00:00.000Z",
  "firstIssuedAt": "2020-01-01T00:00:00.000Z",
  "earliestChargeAt": "2020-01-01T00:00:00.000Z",
  "latestChargeAt": "2020-01-01T00:00:00.000Z",
  "pdfUrl": "abc123",
  "annulledBy": AnnulmentBillingDocumentType
}

Fields

NameDescription

grossTotal (Int)

The gross total amount for the statement (in minor currency units).

netTotal (Int)

The net total amount for the statement (in minor currency units).

taxTotal (Int)

The total amount of tax on the statement (in minor currency units).

Example

{
  "netTotal": 1,
  "taxTotal": 1,
  "grossTotal": 1
}

Fields

NameDescription

attachments (BillingAttachmentConnectionTypeConnection)

billType (BillTypeEnum)

The type of the bill.

closingBalance (Int)

This field returns the closing balance of an issued statement.

consumptionEndDate (Date)

The last day of consumption that this statement includes.

consumptionStartDate (Date)

The first day of consumption that this statement includes.

fromDate (Date)

The date of the constituent bill covered from.

heldStatus (HeldStatus)

Retrieve the held status of a account statement.

id (ID)

The ID of the constituent bill.

isExternalBill (Boolean)

Whether the bill originated in Kraken or externally.

issuedDate (Date)

The date the bill was sent to the customer.

openingBalance (Int)

This field returns the opening balance of a statement.

paymentDueDate (Date)

The date the bill is due to be paid.

reversalsAfterClose (StatementReversalsAfterClose!)

How many charges have been reversed after the close date.

status (AccountStatementStatus)

Current status of the associated statement.

temporaryUrl (String)

Requesting this field generates a temporary URL at which bill is available. This URL will expire after approximately an hour. It is intended for redirection purposes, NOT persistence in any form (e.g. inclusion in emails or the body of a web page). This field can raise an error with errorClass NOT_FOUND if the bill document has not been created/issued yet. This field is deprecated use 'attachments' field instead.

Deprecated

The 'temporaryUrl' field is deprecated.

This field is deprecated. Use the 'attachments' field instead.

- Marked as deprecated on 2024-09-16.
- Will be removed on 2025-09-01.

toAddress (String)

Email recipient address.

toDate (Date)

The date of the constituent bill covered to.

totalCharges (StatementTotalType)

The total amounts for all charges on the statement.

totalCredits (StatementTotalType)

The total amounts for all credits on the statement.

transactions (TransactionConnectionTypeConnection)

Transactions on the bill.

userId (Int)

Email recipient user ID.

Example

{
  "id": "abc123",
  "billType": "STATEMENT",
  "fromDate": "2020-01-01",
  "toDate": "2020-01-01",
  "temporaryUrl": "abc123",
  "issuedDate": "2020-01-01",
  "attachments": BillingAttachmentConnectionTypeConnection,
  "closingBalance": 1,
  "openingBalance": 1,
  "isExternalBill": true,
  "transactions": TransactionConnectionTypeConnection,
  "userId": 1,
  "toAddress": "abc123",
  "paymentDueDate": "2020-01-01",
  "consumptionStartDate": "2020-01-01",
  "consumptionEndDate": "2020-01-01",
  "reversalsAfterClose": "ALL",
  "status": "OPEN",
  "heldStatus": HeldStatus,
  "totalCharges": StatementTotalType,
  "totalCredits": StatementTotalType
}

Fields

NameDescription

costExclTax (EstimatedMoneyType)

Monetary cost of the statistic (excluding tax), if applicable.

costInclTax (EstimatedMoneyType)

Monetary cost of the statistic (including tax), if applicable.

description (String)

Description of the statistic for the parent node.

label (String)

Display label of the statistic for the parent node.

type (ReadingStatisticTypeEnum)

The type of statistic being measured for the parent node.

value (Decimal)

Consumption / generation value of the statistic, if applicable.

Example

{
  "type": "STANDING_CHARGE_COST",
  "label": "abc123",
  "description": "abc123",
  "costExclTax": EstimatedMoneyType,
  "costInclTax": EstimatedMoneyType,
  "value": 1.0
}

StorePaymentInstruction

Store a new payment instruction created through the embedded process.

The possible errors that can be raised are:

  • KT-CT-4177: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

paymentInstruction (PaymentInstructionType)

The stored payment instruction.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "paymentInstruction": PaymentInstructionType
}

SubmitCustomerFeedback

The possible errors that can be raised are:

  • KT-CT-5514: Unable to submit feedback.
  • KT-CT-5511: The feedback_id should be provided for feedback source.
  • KT-CT-5512: The feedback doesn't match the account.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

customerFeedback (CustomerFeedbackType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "customerFeedback": CustomerFeedbackType
}

SubmitRepaymentRequest

Mutation for executing the repayment request use case.

The possible errors that can be raised are:

  • KT-CT-1132: Unauthorized.
  • KT-CT-3927: Invalid Amount.
  • KT-CT-3928: Idempotency key used for another repayment request.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

repaymentRequest (RequestRepaymentOutputType)

The newly created repayment request.

Example

{
  "possibleErrors": [PossibleErrorType],
  "repaymentRequest": RequestRepaymentOutputType
}

SupplementaryLedgerType

Ledgers provide the foundation of Kraken’s bookkeeping functionality. Similar to a bank account, they allow us to keep track of financial activity on a particular Kraken account.

Fields

NameDescription

currentBalance (Int)

The current final balance of the ledger in pence.

id (ID)

ledgerType (String)

name (String)

The display name of the ledger.

paymentAdequacy (PaymentAdequacyDetailsType)

Example

{
  "id": "abc123",
  "name": "abc123",
  "ledgerType": "abc123",
  "currentBalance": 1,
  "paymentAdequacy": PaymentAdequacyDetailsType
}

Fields

NameDescription

brandId (Int)

supplierId (Int)

supplierName (String)

supplierNumber (String)

Example

{
  "brandId": 1,
  "supplierId": 1,
  "supplierName": "abc123",
  "supplierNumber": "abc123"
}

SupplyPointConnectionTypeEdge

A Relay edge containing a SupplyPointConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (SupplyPointType)

The item at the end of the edge

Example

{
  "node": SupplyPointType,
  "cursor": "abc123"
}

Fields

NameDescription

available (Int)

The remaining spins at this moment.

availableWithSubmittedReadings (Int)

The remaining spins assuming all required readings were submitted.

Example

{
  "available": 1,
  "availableWithSubmittedReadings": 1
}

SuspendDeviceControl

Suspend control of a device while away from home, e.g. on holiday.

This is to prevent charging during that period.

The possible errors that can be raised are:

  • KT-CT-4301: Unable to find device for given account.
  • KT-CT-4358: Unable to suspend device control.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

krakenflexDevice (KrakenFlexDeviceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "krakenflexDevice": KrakenFlexDeviceType
}

Fields

NameDescription

electricityTariffs ([Product])

gasTariffs ([Product])

Example

{
  "electricityTariffs": [Product],
  "gasTariffs": [Product]
}

Fields

NameDescription

error (String)

The error message if the task failed.

result (JSONString)

The result of the task.

status (TaskStatusEnum)

The status of the task.

Example

{
  "status": "STARTED",
  "result": {"key": "value"},
  "error": "abc123"
}

TemporarySpecialCircumstanceRecordType

Any special circumstances that the user has notified us about, which may entitle them to some specialist services. These circumstances have an end date, after which they will not longer apply. Having young children is an example of this in the UK.

Fields

NameDescription

expiryDate (Date)

id (ID)

internalCode (String)

summary (String)

Example

{
  "id": "abc123",
  "summary": "abc123",
  "internalCode": "abc123",
  "expiryDate": "2020-01-01"
}

Fields

NameDescription

brandCode (String)

effectiveFrom (DateTime)

html (String)

The html of the terms and conditions document rendered as a JSON string.

markdown (String)

The markdown text of the terms and conditions.

name (String)

pdfUrl (String)

version (String)

Example

{
  "name": "abc123",
  "pdfUrl": "abc123",
  "brandCode": "abc123",
  "markdown": "abc123",
  "html": "abc123",
  "version": "abc123",
  "effectiveFrom": "2020-01-01T00:00:00.000Z"
}

TeslaModifyScopes

A step which indicates that the Tesla permission scopes need to be granted by the user in order to register their vehicle.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

modifyScopesUri (String)

Returns the URI to update the permission scopes.

redirectUri (String)

The redirect URI to return to after updating the permission scopes.

Example

{
  "id": "abc123",
  "modifyScopesUri": "abc123",
  "redirectUri": "abc123"
}

TeslaRegistrationFailed

A step which indicates that the Tesla registration failed and the user must re-grant permission scopes to register their vehicle.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

modifyScopesSelected (Boolean)

Returns:- true if user wants to update permissions scopes.- false if user wants to retry the OAuth journey.- null if user has not made a decision.

Example

{
  "id": "abc123",
  "modifyScopesSelected": true
}

TeslaSetupVirtualKey

A step which indicates that the user must add the given URI as a virtual key in their Tesla account.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

key (String)

The name of the key to add.

uri (String)

The URI to add as a virtual key in the user's Tesla account.

Example

{
  "id": "abc123",
  "key": "abc123",
  "uri": "abc123"
}

TestCharge

A step which indicates if we're able to test charge the user's vehicle(s).

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

isReady (Boolean)

Returns true if the device is ready for a test charge.

status (TestDispatchStatus)

Returns the dispatch status of test charge.

Example

{
  "id": "abc123",
  "isReady": true,
  "status": "TRIGGERED"
}

TextType

A block of text.

Fields

NameDescription

id (ID)

Unique identifier of the object.

textAlignment (Alignment)

The text alignment.

textStyle (TextStyleV1)

The text style, i.e. header, body.

typename (String)

The name of the object's type.

value (String!)

The text content.

Example

{
  "value": "abc123",
  "textStyle": "TITLE1",
  "textAlignment": "START",
  "id": "abc123",
  "typename": "abc123"
}

Fields

NameDescription

discount (Decimal)

The discount that is rewarded when the power crosses the corresponding threshold. Ranges from 0.0 - 1.0.

power (Decimal)

The power (kW) that must be surpassed to achieve the corresponding discount.

windSpeed (Decimal)

The wind speed (m/s) that corresponds to the power cut-off for this threshold.

Example

{
  "power": 1.0,
  "discount": 1.0,
  "windSpeed": 1.0
}

Fields

NameDescription

rates ([TimeOfUseTimeslotUnitRate]!)

The time of use unit rates.

Example


Fields

NameDescription

activeFromTime (Time!)

The time from which the timeslot is active.

activeToTime (Time!)

The time until which the timeslot is active.

Example

{
  "activeFromTime": "00:00:00.000Z",
  "activeToTime": "00:00:00.000Z"
}

Fields

NameDescription

grossRateInformation ([GrossRateInformation]!)

A list of gross rate information.

latestGrossUnitRateCentsPerKwh (Decimal!)

The latest value of the gross unit rate, in ct/kWh.

netUnitRateCentsPerKwh (Decimal!)

The net unit rate, in ct/kWh.

timeslotActivationRules ([TimeOfUseTimeslotActivationRule]!)

Activation rules that describe the timeslot within which this rate applies.

timeslotName (String!)

The name of the timeslot for this unit rate.

Example

{
  "timeslotName": "abc123",
  "timeslotActivationRules": TimeOfUseTimeslotActivationRule,
  "netUnitRateCentsPerKwh": 1.0,
  "latestGrossUnitRateCentsPerKwh": 1.0,
  "grossRateInformation": GrossRateInformation
}

Fields

NameDescription

gross (Int)

The gross amount (in minor currency units).

net (Int)

The net amount (in minor currency units).

tax (Int)

The amount of tax (in minor currency units).

Example

{
  "net": 1,
  "tax": 1,
  "gross": 1
}

Fields

NameDescription

edgeCount (Int!)

Number of nodes in the edge.

edges ([TransactionConnectionTypeEdge]!)

Contains the nodes in this connection.

pageInfo (PageInfo!)

Pagination data for this connection.

totalCount (Int!)

Total number of nodes.

Example

{
  "pageInfo": PageInfo,
  "edges": TransactionConnectionTypeEdge,
  "totalCount": 1,
  "edgeCount": 1
}

TransactionConnectionTypeEdge

A Relay edge containing a TransactionConnectionType and its cursor.

Fields

NameDescription

cursor (String!)

A cursor for use in pagination

node (TransactionType)

The item at the end of the edge

Example

{
  "node": TransactionType,
  "cursor": "abc123"
}

TransferLoyaltyPointsBetweenUsers

Transfer Loyalty Points between users.

The possible errors that can be raised are:

  • KT-CT-1111: Unauthorized.
  • KT-CT-9205: Insufficient Loyalty Points.
  • KT-CT-9204: Negative or zero points set.
  • KT-CT-9208: Invalid posted at datetime.
  • KT-CT-9209: Negative Loyalty Points balance.
  • KT-CT-9210: Unhandled Loyalty Points exception.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

pointsTransferred (Int)

The number of OctoPoints that were transferred.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "pointsTransferred": 1
}

TypedSourceOutput

Note this is deprecated and will be removed in the future. Please use the UtilityFiltersOutput type instead.

Fields

NameDescription

readingDirection (ReadingDirectionType)

Reading direction is based on the utility generated or consumed by the customer.

readingFrequencyType (ReadingFrequencyType)

readingQuality (ReadingQualityType)

sourceIdentifier (String)

utility (UtilityType)

Example

{
  "utility": "ELECTRICITY",
  "sourceIdentifier": "abc123",
  "readingFrequencyType": "RAW_INTERVAL",
  "readingDirection": "CONSUMPTION",
  "readingQuality": "ACTUAL"
}

UpdateAccountBillingAddress

The possible errors that can be raised are:

  • KT-CT-4145: Invalid address.
  • KT-CT-7123: Unauthorized.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

account (AccountType)

The updated account.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "account": AccountType
}

UpdateAccountBillingEmail

Update the billing email for the input account number to the received email value.

The possible errors that can be raised are:

  • KT-CT-4123: Unauthorized.
  • KT-CT-4122: Invalid email.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

account (AccountInterface)

Account that was changed.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "account": AccountInterface
}

UpdateAccountReference

Update a reference for a particular account and namespace.

The possible errors that can be raised are:

  • KT-CT-4123: Unauthorized.
  • KT-CT-8310: Invalid data.
  • KT-CT-8311: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

accountReference (AccountReferenceType)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "accountReference": AccountReferenceType
}

UpdateAccountUserCommsPreferencesMutationPayload

Update the account user comms preferences.

Fields

NameDescription

clientMutationId (String)

commsPreferences (AccountUserCommsPreferences)

emailFormat (String)

errors ([ErrorType])

fontSizeMultiplier (Float)

isOptedInMeterReadingConfirmations (Boolean)

isOptedInToClientMessages (Boolean)

isOptedInToOfferMessages (Boolean)

isOptedInToRecommendedMessages (Boolean)

isOptedInToSmsMessages (Boolean)

isOptedInToThirdPartyMessages (Boolean)

isOptedInToUpdateMessages (Boolean)

isUsingInvertedEmailColours (Boolean)

preferredHoldMusic (String)

Example

{
  "isOptedInToClientMessages": true,
  "isOptedInToOfferMessages": true,
  "isOptedInToRecommendedMessages": true,
  "isOptedInToUpdateMessages": true,
  "isOptedInToThirdPartyMessages": true,
  "isOptedInMeterReadingConfirmations": true,
  "isOptedInToSmsMessages": true,
  "isUsingInvertedEmailColours": true,
  "fontSizeMultiplier": 1.0,
  "emailFormat": "abc123",
  "preferredHoldMusic": "abc123",
  "errors": [ErrorType],
  "commsPreferences": AccountUserCommsPreferences,
  "clientMutationId": "abc123"
}

Fields

NameDescription

clientMutationId (String)

dateOfBirth (Date)

email (String)

errors ([ErrorType])

familyName (String)

givenName (String)

landline (String)

mobile (String)

pronouns (String)

Example

{
  "givenName": "abc123",
  "familyName": "abc123",
  "pronouns": "abc123",
  "mobile": "abc123",
  "email": "abc123",
  "dateOfBirth": "2020-01-01",
  "landline": "abc123",
  "errors": [ErrorType],
  "clientMutationId": "abc123"
}

UpdateActivePurchase

The possible errors that can be raised are:

  • KT-CT-8225: Received an invalid purchaseId.
  • KT-CT-8226: The provided purchase is not active.
  • KT-CT-8206: Invalid data.
  • KT-CT-8227: Available grants could not be applied.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

goodsPurchase (GoodsPurchase)

Goods purchase updated.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "goodsPurchase": GoodsPurchase
}

UpdateAutoTopUpAmount

The possible errors that can be raised are:

  • KT-CT-3815: No active payment schedule found for this account.
  • KT-CT-3941: Invalid data.
  • KT-CT-3942: An unexpected error occurred.
  • KT-CT-3947: An unexpected error occurred.
  • KT-CT-3953: The payment schedule is not a balance triggered schedule.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

schedule (PaymentScheduleType)

The new schedule created.

Example

{
  "possibleErrors": [PossibleErrorType],
  "schedule": PaymentScheduleType
}

UpdateCommsDeliveryPreference

Update the comms delivery preference for the input account number to the received commsDeliveryPreference value.

The possible errors that can be raised are:

  • KT-CT-4123: Unauthorized.
  • KT-CT-4136: Cannot set comms preference to email when account has no email.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

account (AccountInterface)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "account": AccountInterface
}

UpdateMetadata

Update existing metadata on an object.

The possible errors that can be raised are:

  • KT-CT-8413: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

metadata (Metadata)

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "metadata": Metadata
}

UpdatePassword

Update user's password.

Fields

NameDescription

viewer (AccountUserType)

The currently authenticated user.

This field requires the Authorization header to be set.

Example

{
  "viewer": AccountUserType
}

UpdatePaymentSchedulePaymentAmount

The possible errors that can be raised are:

  • KT-DE-3910: Invalid data.
  • KT-DE-3915: Invalid data.
  • KT-DE-3901: Failed while checking if the ledger has existing schedules and the amount can be updated.
  • KT-DE-3917: Invalid data.
  • KT-DE-3918: Invalid data.
  • KT-DE-3916: Invalid data.
  • KT-DE-3902: Updating the payment amount on the ledger failed.
  • KT-DE-3912: Invalid data.
  • KT-DE-3919: A payment schedule for a time-of-use tariff cannot be updated.
  • KT-DE-3920: No active or pending agreement found.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

paymentSchedule (PaymentScheduleType)

The payment schedule that is being updated.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "paymentSchedule": PaymentScheduleType
}

UpdatePaymentSchedulePaymentDay

The possible errors that can be raised are:

  • KT-DE-3910: Invalid data.
  • KT-DE-3913: Invalid data.
  • KT-DE-3919: A payment schedule for a time-of-use tariff cannot be updated.
  • KT-DE-3920: No active or pending agreement found.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

paymentSchedule (PaymentScheduleType)

The payment schedule that is being updated.

possibleErrors ([PossibleErrorType])

Example

{
  "possibleErrors": [PossibleErrorType],
  "paymentSchedule": PaymentScheduleType
}

UpdateUserMutation

The possible errors that can be raised are:

  • KT-CT-5413: Invalid data.
  • KT-CT-5414: Invalid data.
  • KT-CT-1113: Disabled GraphQL field requested.
  • KT-CT-1111: Unauthorized.
  • KT-CT-1112: 'Authorization' header not provided.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

viewer (AccountUserType)

Example

{
  "possibleErrors": [PossibleErrorType],
  "viewer": AccountUserType
}

Fields

NameDescription

location (String)

Present for completed dispatches, otherwise null. The only relevant value is AT_HOME if present.

source (String)

Present for planned dispatches, otherwise null. Value can be smart-charge, test-charge or bump-charge.

Example

{
  "source": "abc123",
  "location": "abc123"
}

Fields

NameDescription

delta (Decimal)

Energy in kWh (import has a negative value).

deltaKwh (Int)

This field has been replaced by delta.

Deprecated

The 'delta_kwh' field is deprecated.

`delta` has replaced `deltaKwh` for increased precision.

- Marked as deprecated on 2024-04-19.
- Will be removed on 2025-01-01.

end (DateTime!)

The end time of the dispatch.

endDt (String)

This field has been replaced by end.

Deprecated

The 'end_dt' field is deprecated.

`end` has replaced `end_dt` for improved typing.

- Marked as deprecated on 2024-04-19.
- Will be removed on 2025-01-01.

meta (UpsideDispatchMetaType)

start (DateTime!)

The start time of the dispatch.

startDt (String)

This field has been replaced by start.

Deprecated

The 'start_dt' field is deprecated.

`start` has replaced `start_dt` for improved typing.

- Marked as deprecated on 2024-04-19.
- Will be removed on 2025-01-01.

Example

{
  "start": "2020-01-01T00:00:00.000Z",
  "end": "2020-01-01T00:00:00.000Z",
  "startDt": "abc123",
  "endDt": "abc123",
  "deltaKwh": 1,
  "delta": 1.0,
  "meta": UpsideDispatchMetaType
}

Fields

NameDescription

information (VehicleInformationType)

vehicleId (String)

Example

{
  "vehicleId": "abc123",
  "information": VehicleInformationType
}

Fields

NameDescription

maximumSocPercentage (Int)

The maximum state of charge (soc) %, if available.

minimumSocPercentage (Int)

The minimum state of charge (soc) %, if available.

weekdayTargetSoc (Int)

weekdayTargetTime (String)

weekendTargetSoc (Int)

weekendTargetTime (String)

Example

{
  "weekdayTargetTime": "abc123",
  "weekdayTargetSoc": 1,
  "weekendTargetTime": "abc123",
  "weekendTargetSoc": 1,
  "minimumSocPercentage": 1,
  "maximumSocPercentage": 1
}

Fields

NameDescription

brand (String)

displayName (String)

The (user chosen) display name of the vehicle, if available.

model (String)

The model name of the vehicle, if available (e.g. i3s 120).

vin (String)

year (Int)

The year of the vehicle model, if available.

Example

{
  "vin": "abc123",
  "brand": "abc123",
  "model": "abc123",
  "year": 1,
  "displayName": "abc123"
}

VerifyIdentity

The possible errors that can be raised are:

  • KT-CT-1145: Account/user details do not match.
  • KT-CT-1113: Disabled GraphQL field requested.

Fields

NameDescription

possibleErrors ([PossibleErrorType])

token (String!)

An expiring token that can be used to request to update the user's email address.

Example

{
  "possibleErrors": [PossibleErrorType],
  "token": "abc123"
}

WaitForLiveIntegration

Indicates a step where the integration is pending activation.

Progress to the next onboarding step is blocked until the integration becomes active.

Fields

NameDescription

id (ID)

A unique identifier for this onboarding step.

isLive (Boolean)

Returns true if the device integration is supported by us, false otherwise.

Example

{
  "id": "abc123",
  "isLive": true
}

Fields

NameDescription

body (String!)

Whatsapp text message body.

Example

{
  "body": "abc123"
}

Fields

NameDescription

prizeAmount (Int)

The amount won in cents.

Example

{
  "prizeAmount": 1
}

Fields

NameDescription

segments ([Int])

The integer values that make up the WoF segments.

Example

{
  "segments": [1]
}