About Queries
Every GraphQL schema has a root type for both queries and mutations. The query type defines GraphQL operations that retrieve data from the server.
The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.
API Site
account
Type: AccountType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about an account.
The possible errors that can be raised are:
- KT-CT-4177: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query Account($accountNumber: String!) {
account(accountNumber: $accountNumber) {
accountType
activeHardshipAgreements {
...HardshipAgreementTypeFragment
}
activeReferralSchemes {
...ReferralSchemeTypesFragment
}
address {
...RichAddressTypeFragment
}
annualStatements {
...AnnualStatementConnectionTypeConnectionFragment
}
applications {
...AccountApplicationConnectionTypeConnectionFragment
}
assistanceAgreements {
...AssistanceAgreementTypeFragment
}
balance
bill {
...BillInterfaceFragment
}
billingAddress
billingAddressLine1
billingAddressLine2
billingAddressLine3
billingAddressLine4
billingAddressLine5
billingAddressPostcode
billingCountryCode
billingDeliveryPointIdentifier
billingEmail
billingName
billingOptions {
...BillingOptionsTypeFragment
}
billingPostcode
billingSubName
bills {
...BillConnectionTypeConnectionFragment
}
brand
business {
...BusinessTypeFragment
}
campaigns {
...AccountCampaignTypeFragment
}
canBeWithdrawn
canChangePayments
canInputMeterReadingsViaIvr
canModifyPayments {
...CanModifyPaymentsTypeFragment
}
canRenewTariff
canRequestRefund
commsDeliveryPreference
complaints {
...ComplaintConnectionTypeConnectionFragment
}
consents {
...ConsentTypeFragment
}
contributionAgreements {
...ContributionAgreementTypeFragment
}
cotReadingWindowDays
createdAt
currentEstimatedSsd
debtCollectionProceedings {
...DebtCollectionProceedingTypeFragment
}
directDebitInstructions {
...DirectDebitInstructionConnectionTypeConnectionFragment
}
documentAccessibility
earliestPossibleSsd
electricityAgreements {
...ElectricityAgreementTypeFragment
}
eligibilityForWarmHomeDiscount {
...WarmHomeDiscountEligibilityFragment
}
events {
...AccountEventConnectionTypeConnectionFragment
}
fileAttachments {
...AccountFileAttachmentFragment
}
gasAgreements {
...GasAgreementTypeFragment
}
greenAccomplishments {
...GreenAccomplishmentsTypeFragment
}
hasActiveCollectionsProceedings
hasActiveDunningProcess
id
isInBlockingMigration
isInHardship
latestPossibleSsd
ledgers {
...LedgerTypeFragment
}
marketSupplyAgreements {
...AgreementConnectionFragment
}
maximumRefund {
...MaximumRefundTypeFragment
}
metadata {
...MetadataFragment
}
notes {
...AccountNoteTypeFragment
}
number
operationsTeam {
...OperationsTeamTypeFragment
}
overdueBalance
paginatedFileAttachments {
...AccountFileAttachmentConnectionTypeConnectionFragment
}
paginatedPaymentForecast {
...PaymentForecastConnectionTypeConnectionFragment
}
paymentAdequacy {
...PaymentAdequacyTypeFragment
}
paymentMethods {
...PaymentInstructionConnectionTypeConnectionFragment
}
paymentPlans {
...PaymentPlanConnectionTypeConnectionFragment
}
paymentSchedules {
...PaymentScheduleConnectionTypeConnectionFragment
}
payments {
...AccountPaymentConnectionTypeConnectionFragment
}
portfolio {
...PortfolioTypeFragment
}
preferredLanguageForComms
projectedBalance
properties {
...PropertyTypeFragment
}
provisionalTransactions {
...ProvisionalTransactionConnectionTypeConnectionFragment
}
recommendedBalanceAdjustment
references {
...AccountReferenceTypeFragment
}
referrals {
...ReferralConnectionTypeConnectionFragment
}
referralsCreated
refundApproval {
...RefundApprovalTypeFragment
}
reminders {
...AccountReminderConnectionTypeConnectionFragment
}
repayments {
...AccountRepaymentConnectionTypeConnectionFragment
}
requestRefundEligibility {
...RequestRefundEligibilityTypeFragment
}
rewards {
...RewardTypeFragment
}
shouldReviewPayments
smets2Interest
smets2RefusalReason
splitBillingAddress
status
trackerTariffDailyPricing {
...TrackerTariffDailyPricingFragment
}
transactions {
...TransactionConnectionTypeConnectionFragment
}
urn
users {
...AccountUserTypeFragment
}
warmHomeDiscount {
...WarmHomeDiscountFragment
}
}
}
Variables
{
"accountNumber": "A-5FC5F7AF"
}
Response
{
"data": {
"account": {
"accountType": "BUSINESS",
"activeHardshipAgreements": [HardshipAgreementType],
"activeReferralSchemes": ReferralSchemeTypes,
"address": RichAddressType,
"annualStatements": AnnualStatementConnectionTypeConnection,
"applications": AccountApplicationConnectionTypeConnection,
"assistanceAgreements": [AssistanceAgreementType],
"balance": 80,
"bill": BillInterface,
"billingAddress": "memory-million-dream-bit-everybody",
"billingAddressLine1": "run-material-between-tree-action",
"billingAddressLine2": "else-technology-herself-me-join",
"billingAddressLine3": "say-social-include-tree-including",
"billingAddressLine4": "air-not-system-of-friend",
"billingAddressLine5": "ago-baby-more-relate-radio",
"billingAddressPostcode": "break-clearly-former-figure-every",
"billingCountryCode": "away-world-prevent-food-probably",
"billingDeliveryPointIdentifier": "74596533",
"billingEmail": "debate-quite-whom-choice-smile",
"billingName": "sign-before-leg-value-understand",
"billingOptions": BillingOptionsType,
"billingPostcode": "dinner-team-evening-reality-kid",
"billingSubName": "town-treat-meeting-effect-give",
"bills": BillConnectionTypeConnection,
"brand": "whom-political-sure-interview-eye",
"business": BusinessType,
"campaigns": [AccountCampaignType],
"canBeWithdrawn": true,
"canChangePayments": true,
"canInputMeterReadingsViaIvr": true,
"canModifyPayments": CanModifyPaymentsType,
"canRenewTariff": true,
"canRequestRefund": true,
"commsDeliveryPreference": "EMAIL",
"complaints": ComplaintConnectionTypeConnection,
"consents": ConsentType,
"contributionAgreements": [ContributionAgreementType],
"cotReadingWindowDays": 2,
"createdAt": "1975-06-07T12:53:52.542311+00:00",
"currentEstimatedSsd": "2014-04-08",
"debtCollectionProceedings": [DebtCollectionProceedingType],
"directDebitInstructions": DirectDebitInstructionConnectionTypeConnection,
"documentAccessibility": "LARGE_PRINT",
"earliestPossibleSsd": "2010-05-16",
"electricityAgreements": [ElectricityAgreementType],
"eligibilityForWarmHomeDiscount": WarmHomeDiscountEligibility,
"events": AccountEventConnectionTypeConnection,
"fileAttachments": [AccountFileAttachment],
"gasAgreements": [GasAgreementType],
"greenAccomplishments": GreenAccomplishmentsType,
"hasActiveCollectionsProceedings": true,
"hasActiveDunningProcess": true,
"id": "40024816",
"isInBlockingMigration": true,
"isInHardship": true,
"latestPossibleSsd": "1983-06-24",
"ledgers": [LedgerType],
"marketSupplyAgreements": AgreementConnection,
"maximumRefund": MaximumRefundType,
"metadata": [Metadata],
"notes": [AccountNoteType],
"number": "long-outside-either-network-able",
"operationsTeam": OperationsTeamType,
"overdueBalance": 46,
"paginatedFileAttachments": AccountFileAttachmentConnectionTypeConnection,
"paginatedPaymentForecast": PaymentForecastConnectionTypeConnection,
"paymentAdequacy": PaymentAdequacyType,
"paymentMethods": PaymentInstructionConnectionTypeConnection,
"paymentPlans": PaymentPlanConnectionTypeConnection,
"paymentSchedules": PaymentScheduleConnectionTypeConnection,
"payments": AccountPaymentConnectionTypeConnection,
"portfolio": PortfolioType,
"preferredLanguageForComms": "main-management-central-allow-head",
"projectedBalance": 28,
"properties": [PropertyType],
"provisionalTransactions": ProvisionalTransactionConnectionTypeConnection,
"recommendedBalanceAdjustment": 89,
"references": [AccountReferenceType],
"referrals": ReferralConnectionTypeConnection,
"referralsCreated": 50,
"refundApproval": RefundApprovalType,
"reminders": AccountReminderConnectionTypeConnection,
"repayments": AccountRepaymentConnectionTypeConnection,
"requestRefundEligibility": RequestRefundEligibilityType,
"rewards": [RewardType],
"shouldReviewPayments": true,
"smets2Interest": "PRIORITY",
"smets2RefusalReason": "SMETS2_INTEREST_REASON_DO_NOT_OWN_HOME",
"splitBillingAddress": ["discuss-hour-significant-every-parent"],
"status": "PENDING",
"trackerTariffDailyPricing": TrackerTariffDailyPricing,
"transactions": TransactionConnectionTypeConnection,
"urn": "else-blood-road-everything-two",
"users": AccountUserType,
"warmHomeDiscount": WarmHomeDiscount
}
}
}
accountChargeReasons
Type: [ChargeReasonType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Available reasons for use in account charge mutations.
Query
query AccountChargeReasons {
accountChargeReasons {
code
display
group
isDeprecated
isHidden
isTaxExempt
}
}
Response
{
"data": {
"accountChargeReasons": [
{
"code": "meet-situation-soldier-play-where",
"display": "board-clearly-religious-wrong-low",
"group": "bad-build-feel-chair-game",
"isDeprecated": true,
"isHidden": true,
"isTaxExempt": true
}
]
}
}
accountContract
Type: Contract
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about an account contract.
The possible errors that can be raised are:
- KT-CT-10003: Contract not found.
- KT-CT-10005: Missing required parameter: either identifier or accountNumber must be provided.
- KT-CT-10006: Account not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number to find the contract for. |
|
The identifier of the contract. |
|
The version of the contract. |
Query
query AccountContract(
$accountNumber: String,
$identifier: String,
$version: Int
) {
accountContract(
accountNumber: $accountNumber,
identifier: $identifier,
version: $version
) {
cancelledAt
identifier
lifecycle {
...ContractVersionFragment
}
party {
... on AccountType {
...AccountTypeFragment
}
... on BusinessType {
...BusinessTypeFragment
}
}
signedAt
status
subject {
...AccountTypeFragment
}
terms {
...TermInterfaceFragment
}
title
validFrom
validTo
}
}
Variables
{
"accountNumber": "A-61872F49",
"identifier": "68433282",
"version": 64
}
Response
{
"data": {
"accountContract": {
"cancelledAt": "2025-03-09T12:47:03.084862+00:00",
"identifier": "22099266",
"lifecycle": ContractVersion,
"party": AccountType,
"signedAt": "1993-02-26T17:39:15.621963+00:00",
"status": "REVOKED",
"subject": [AccountType],
"terms": TermInterface,
"title": "edge-again-anyone-week-instead",
"validFrom": "2024-11-26T06:21:15.530067+00:00",
"validTo": "2010-12-28T06:20:23.996226+00:00"
}
}
}
accountCreditReasons
Type: [CreditReasonType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Available reasons for use in account credit mutations.
Query
query AccountCreditReasons {
accountCreditReasons {
code
display
group
isDeprecated
isHidden
isTaxExempt
}
}
Response
{
"data": {
"accountCreditReasons": [
{
"code": "assume-beyond-choice-some-table",
"display": "wall-deal-consumer-look-debate",
"group": "speak-politics-throughout-range-yeah",
"isDeprecated": true,
"isHidden": true,
"isTaxExempt": true
}
]
}
}
accountIoEligibility
Type: AccountIoEligibility
URL: https://api.oeg-kraken.energy/v1/graphql/
Determines whether an account is eligible to register devices with SmartFlex.
Arguments
| Name | Description |
|---|---|
|
Account number. |
|
|
Query
query AccountIoEligibility(
$accountNumber: String!,
$propertyId: Int
) {
accountIoEligibility(
accountNumber: $accountNumber,
propertyId: $propertyId
) {
isEligibleForIo
}
}
Variables
{
"accountNumber": "A-588692D4",
"propertyId": 76340408
}
Response
{
"data": {
"accountIoEligibility": {
"isEligibleForIo": true
}
}
}
accountReference
Type: [AccountReferenceType]
URL: https://api.oeg-kraken.energy/v1/graphql/
List of matching account references.
The possible errors that can be raised are:
- KT-CT-8310: Invalid data.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Filter account references by this value. |
Query
query AccountReference($value: String) {
accountReference(value: $value) {
account {
...AccountTypeFragment
}
createdAt
namespace
updatedAt
value
}
}
Variables
{
"value": "owner-media-dinner-pretty-recently"
}
Response
{
"data": {
"accountReference": [
{
"account": AccountType,
"createdAt": "2018-01-20T11:34:01.103676+00:00",
"namespace": "him-training-election-how-turn",
"updatedAt": "2004-09-06T18:37:00.678723+00:00",
"value": "month-offer-century-run-media"
}
]
}
}
accountUser
Type: AccountUserType
URL: https://api.oeg-kraken.energy/v1/graphql/
Retrieve an account user.
The possible errors that can be raised are:
- KT-CT-5418: Account user not found.
- KT-CT-5415: Account user not found.
- KT-CT-5423: Account user not found.
- KT-CT-5424: Invalid data.
- KT-CT-5421: Account user not found.
- KT-CT-5425: Account user not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Email associated with an account user. |
|
External ID associated with an account user. |
|
Kraken number associated with an account user. |
Query
query AccountUser(
$email: String,
$externalId: ID,
$number: ID
) {
accountUser(
email: $email,
externalId: $externalId,
number: $number
) {
accountUserRoles {
...AccountUserRoleTypeFragment
}
accounts {
...AccountInterfaceFragment
}
address {
...RichAddressTypeFragment
}
alternativePhoneNumbers
businesses {
...BusinessConnectionTypeConnectionFragment
}
consents {
...ConsentTypeFragment
}
createdAt
dateOfBirth
details {
...AccountUserDetailTypeFragment
}
email
familyName
fullName
givenName
hasFamilyIssues
holdMusicChoices {
...TrackOptionTypeFragment
}
id
isActive
isDeceased
isInHardship
isOptedInToWof
label
landline
liveSecretKey
mobile
number
paymentMethods {
...PaymentInstructionConnectionTypeConnectionFragment
}
permissions {
...AccountUserPermissionFragment
}
portfolioIds
portfolioUserRoles {
...PortfolioUserRoleTypeFragment
}
portfolios {
...PortfolioConnectionTypeConnectionFragment
}
preferences {
...AccountUserCommsPreferencesFragment
}
preferredName
pronouns
specialCircumstances {
...SpecialCircumstancesTypeFragment
}
title
}
}
Variables
{
"email": "wrong-various-between-always-increase",
"externalId": "21047804",
"number": "47525391"
}
Response
{
"data": {
"accountUser": {
"accountUserRoles": [AccountUserRoleType],
"accounts": AccountInterface,
"address": RichAddressType,
"alternativePhoneNumbers": ["while-activity-throw-network-notice"],
"businesses": BusinessConnectionTypeConnection,
"consents": ConsentType,
"createdAt": "1996-03-02T03:27:45.241570+00:00",
"dateOfBirth": "2006-02-08",
"details": [AccountUserDetailType],
"email": "class-start-green-sister-fast",
"familyName": "Mayer",
"fullName": "my-agree-process-page-not",
"givenName": "Patrick",
"hasFamilyIssues": true,
"holdMusicChoices": [TrackOptionType],
"id": "97064076",
"isActive": true,
"isDeceased": true,
"isInHardship": true,
"isOptedInToWof": true,
"label": "too-contain-statement-audience-foot",
"landline": "nice-play-door-surface-year",
"liveSecretKey": "tree-computer-full-no-purpose",
"mobile": "suffer-building-chance-common-however",
"number": "travel-add-about-woman-her",
"paymentMethods": PaymentInstructionConnectionTypeConnection,
"permissions": [AccountUserPermission],
"portfolioIds": ["75091168"],
"portfolioUserRoles": [PortfolioUserRoleType],
"portfolios": PortfolioConnectionTypeConnection,
"preferences": AccountUserCommsPreferences,
"preferredName": "affect-next-pull-meeting-current",
"pronouns": "view-and-partner-positive-low",
"specialCircumstances": SpecialCircumstancesType,
"title": "must-power-involve-three-glass"
}
}
}
accounts
Type: [AccountType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about multiple accounts.
The possible errors that can be raised are:
- KT-CT-4184: Exactly one of phoneNumber or portfolioNumber must be provided.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
A phone number to find accounts associated with. |
|
A portfolio number to find accounts associated with. |
Query
query Accounts(
$phoneNumber: String,
$portfolioNumber: String
) {
accounts(
phoneNumber: $phoneNumber,
portfolioNumber: $portfolioNumber
) {
accountType
activeHardshipAgreements {
...HardshipAgreementTypeFragment
}
activeReferralSchemes {
...ReferralSchemeTypesFragment
}
address {
...RichAddressTypeFragment
}
annualStatements {
...AnnualStatementConnectionTypeConnectionFragment
}
applications {
...AccountApplicationConnectionTypeConnectionFragment
}
assistanceAgreements {
...AssistanceAgreementTypeFragment
}
balance
bill {
...BillInterfaceFragment
}
billingAddress
billingAddressLine1
billingAddressLine2
billingAddressLine3
billingAddressLine4
billingAddressLine5
billingAddressPostcode
billingCountryCode
billingDeliveryPointIdentifier
billingEmail
billingName
billingOptions {
...BillingOptionsTypeFragment
}
billingPostcode
billingSubName
bills {
...BillConnectionTypeConnectionFragment
}
brand
business {
...BusinessTypeFragment
}
campaigns {
...AccountCampaignTypeFragment
}
canBeWithdrawn
canChangePayments
canInputMeterReadingsViaIvr
canModifyPayments {
...CanModifyPaymentsTypeFragment
}
canRenewTariff
canRequestRefund
commsDeliveryPreference
complaints {
...ComplaintConnectionTypeConnectionFragment
}
consents {
...ConsentTypeFragment
}
contributionAgreements {
...ContributionAgreementTypeFragment
}
cotReadingWindowDays
createdAt
currentEstimatedSsd
debtCollectionProceedings {
...DebtCollectionProceedingTypeFragment
}
directDebitInstructions {
...DirectDebitInstructionConnectionTypeConnectionFragment
}
documentAccessibility
earliestPossibleSsd
electricityAgreements {
...ElectricityAgreementTypeFragment
}
eligibilityForWarmHomeDiscount {
...WarmHomeDiscountEligibilityFragment
}
events {
...AccountEventConnectionTypeConnectionFragment
}
fileAttachments {
...AccountFileAttachmentFragment
}
gasAgreements {
...GasAgreementTypeFragment
}
greenAccomplishments {
...GreenAccomplishmentsTypeFragment
}
hasActiveCollectionsProceedings
hasActiveDunningProcess
id
isInBlockingMigration
isInHardship
latestPossibleSsd
ledgers {
...LedgerTypeFragment
}
marketSupplyAgreements {
...AgreementConnectionFragment
}
maximumRefund {
...MaximumRefundTypeFragment
}
metadata {
...MetadataFragment
}
notes {
...AccountNoteTypeFragment
}
number
operationsTeam {
...OperationsTeamTypeFragment
}
overdueBalance
paginatedFileAttachments {
...AccountFileAttachmentConnectionTypeConnectionFragment
}
paginatedPaymentForecast {
...PaymentForecastConnectionTypeConnectionFragment
}
paymentAdequacy {
...PaymentAdequacyTypeFragment
}
paymentMethods {
...PaymentInstructionConnectionTypeConnectionFragment
}
paymentPlans {
...PaymentPlanConnectionTypeConnectionFragment
}
paymentSchedules {
...PaymentScheduleConnectionTypeConnectionFragment
}
payments {
...AccountPaymentConnectionTypeConnectionFragment
}
portfolio {
...PortfolioTypeFragment
}
preferredLanguageForComms
projectedBalance
properties {
...PropertyTypeFragment
}
provisionalTransactions {
...ProvisionalTransactionConnectionTypeConnectionFragment
}
recommendedBalanceAdjustment
references {
...AccountReferenceTypeFragment
}
referrals {
...ReferralConnectionTypeConnectionFragment
}
referralsCreated
refundApproval {
...RefundApprovalTypeFragment
}
reminders {
...AccountReminderConnectionTypeConnectionFragment
}
repayments {
...AccountRepaymentConnectionTypeConnectionFragment
}
requestRefundEligibility {
...RequestRefundEligibilityTypeFragment
}
rewards {
...RewardTypeFragment
}
shouldReviewPayments
smets2Interest
smets2RefusalReason
splitBillingAddress
status
trackerTariffDailyPricing {
...TrackerTariffDailyPricingFragment
}
transactions {
...TransactionConnectionTypeConnectionFragment
}
urn
users {
...AccountUserTypeFragment
}
warmHomeDiscount {
...WarmHomeDiscountFragment
}
}
}
Variables
{
"phoneNumber": "best-hear-often-might-well",
"portfolioNumber": "P-83F24227"
}
Response
{
"data": {
"accounts": [
{
"accountType": "BUSINESS",
"activeHardshipAgreements": [HardshipAgreementType],
"activeReferralSchemes": ReferralSchemeTypes,
"address": RichAddressType,
"annualStatements": AnnualStatementConnectionTypeConnection,
"applications": AccountApplicationConnectionTypeConnection,
"assistanceAgreements": [AssistanceAgreementType],
"balance": 27,
"bill": BillInterface,
"billingAddress": "whole-drive-land-day-history",
"billingAddressLine1": "down-summer-record-beat-particular",
"billingAddressLine2": "nothing-continue-its-situation-our",
"billingAddressLine3": "figure-art-kid-to-anyone",
"billingAddressLine4": "of-business-explain-important-challenge",
"billingAddressLine5": "source-many-focus-he-finish",
"billingAddressPostcode": "member-practice-them-certainly-do",
"billingCountryCode": "hard-strong-grow-cold-improve",
"billingDeliveryPointIdentifier": "86974318",
"billingEmail": "we-national-practice-oil-occur",
"billingName": "main-such-nation-black-usually",
"billingOptions": BillingOptionsType,
"billingPostcode": "need-person-door-eight-free",
"billingSubName": "these-energy-million-data-nearly",
"bills": BillConnectionTypeConnection,
"brand": "dream-what-hot-explain-inside",
"business": BusinessType,
"campaigns": [AccountCampaignType],
"canBeWithdrawn": true,
"canChangePayments": true,
"canInputMeterReadingsViaIvr": true,
"canModifyPayments": CanModifyPaymentsType,
"canRenewTariff": true,
"canRequestRefund": true,
"commsDeliveryPreference": "EMAIL",
"complaints": ComplaintConnectionTypeConnection,
"consents": ConsentType,
"contributionAgreements": [ContributionAgreementType],
"cotReadingWindowDays": 90,
"createdAt": "1996-04-04T14:39:02.305059+00:00",
"currentEstimatedSsd": "1993-01-11",
"debtCollectionProceedings": [DebtCollectionProceedingType],
"directDebitInstructions": DirectDebitInstructionConnectionTypeConnection,
"documentAccessibility": "LARGE_PRINT",
"earliestPossibleSsd": "2006-10-24",
"electricityAgreements": [ElectricityAgreementType],
"eligibilityForWarmHomeDiscount": WarmHomeDiscountEligibility,
"events": AccountEventConnectionTypeConnection,
"fileAttachments": [AccountFileAttachment],
"gasAgreements": [GasAgreementType],
"greenAccomplishments": GreenAccomplishmentsType,
"hasActiveCollectionsProceedings": true,
"hasActiveDunningProcess": true,
"id": "74950328",
"isInBlockingMigration": true,
"isInHardship": true,
"latestPossibleSsd": "1981-06-29",
"ledgers": [LedgerType],
"marketSupplyAgreements": AgreementConnection,
"maximumRefund": MaximumRefundType,
"metadata": [Metadata],
"notes": [AccountNoteType],
"number": "structure-control-grow-everyone-then",
"operationsTeam": OperationsTeamType,
"overdueBalance": 82,
"paginatedFileAttachments": AccountFileAttachmentConnectionTypeConnection,
"paginatedPaymentForecast": PaymentForecastConnectionTypeConnection,
"paymentAdequacy": PaymentAdequacyType,
"paymentMethods": PaymentInstructionConnectionTypeConnection,
"paymentPlans": PaymentPlanConnectionTypeConnection,
"paymentSchedules": PaymentScheduleConnectionTypeConnection,
"payments": AccountPaymentConnectionTypeConnection,
"portfolio": PortfolioType,
"preferredLanguageForComms": "begin-finally-structure-report-state",
"projectedBalance": 36,
"properties": [PropertyType],
"provisionalTransactions": ProvisionalTransactionConnectionTypeConnection,
"recommendedBalanceAdjustment": 57,
"references": [AccountReferenceType],
"referrals": ReferralConnectionTypeConnection,
"referralsCreated": 5,
"refundApproval": RefundApprovalType,
"reminders": AccountReminderConnectionTypeConnection,
"repayments": AccountRepaymentConnectionTypeConnection,
"requestRefundEligibility": RequestRefundEligibilityType,
"rewards": [RewardType],
"shouldReviewPayments": true,
"smets2Interest": "PRIORITY",
"smets2RefusalReason": "SMETS2_INTEREST_REASON_DO_NOT_OWN_HOME",
"splitBillingAddress": ["how-character-song-case-network"],
"status": "PENDING",
"trackerTariffDailyPricing": TrackerTariffDailyPricing,
"transactions": TransactionConnectionTypeConnection,
"urn": "although-relate-write-we-theory",
"users": AccountUserType,
"warmHomeDiscount": WarmHomeDiscount
}
]
}
}
accountsSearch
Type: [AccountSearchItemType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Search for account that are already in Kraken and match the search terms.
The possible errors that can be raised are:
- KT-CT-4183: One of more search terms failed validations.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The maximum number of results to return. |
|
Search operators. |
Query
query AccountsSearch(
$maxResults: Int,
$searchTerms: AccountSearchInputType
) {
accountsSearch(
maxResults: $maxResults,
searchTerms: $searchTerms
) {
account {
...AccountTypeFragment
}
score
}
}
Variables
{
"maxResults": 16,
"searchTerms": AccountSearchInputType
}
Response
{
"data": {
"accountsSearch": [
{
"account": AccountType,
"score": "1.0"
}
]
}
}
activeAffiliateReferralScheme
Type: ReferralSchemeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return the current active referral reward scheme of a given affiliate organisation, if any exists.
Arguments
| Name | Description |
|---|---|
|
The account type for which to get the referral scheme. |
|
The affiliate link subdomain. |
Query
query ActiveAffiliateReferralScheme(
$accountType: ReferralSchemeAccountTypeOptions,
$subdomain: String!
) {
activeAffiliateReferralScheme(
accountType: $accountType,
subdomain: $subdomain
) {
canBeReferred
code
combinedRewardAmount
isUsageAtCapacity
loyaltyPointsBonus
maxRecurrence
referralDisplayUrl
referralUrl
referredRewardAmount
referrerGivenName
referrerRewardAmount
schemeType
}
}
Variables
{
"accountType": "DOMESTIC",
"subdomain": "drive-arrive-building-scientist-I"
}
Response
{
"data": {
"activeAffiliateReferralScheme": {
"canBeReferred": true,
"code": "since-production-bed-sport-hour",
"combinedRewardAmount": 58,
"isUsageAtCapacity": true,
"loyaltyPointsBonus": 63,
"maxRecurrence": 11,
"referralDisplayUrl": "note-impact-close-however-yes",
"referralUrl": "popular-large-apply-nice-discussion",
"referredRewardAmount": 65,
"referrerGivenName": "Marcus",
"referrerRewardAmount": 46,
"schemeType": "any-human-like-push-his"
}
}
}
activeDomesticSignupRewardScheme
Type: ReferralSchemeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return the current active signup referral reward scheme with the given code, if any exists.
Query
query ActiveDomesticSignupRewardScheme {
activeDomesticSignupRewardScheme {
canBeReferred
code
combinedRewardAmount
isUsageAtCapacity
loyaltyPointsBonus
maxRecurrence
referralDisplayUrl
referralUrl
referredRewardAmount
referrerGivenName
referrerRewardAmount
schemeType
}
}
Response
{
"data": {
"activeDomesticSignupRewardScheme": {
"canBeReferred": true,
"code": "look-set-position-board-education",
"combinedRewardAmount": 38,
"isUsageAtCapacity": true,
"loyaltyPointsBonus": 64,
"maxRecurrence": 72,
"referralDisplayUrl": "camera-just-at-dream-order",
"referralUrl": "indicate-claim-there-picture-memory",
"referredRewardAmount": 61,
"referrerGivenName": "James",
"referrerRewardAmount": 45,
"schemeType": "interview-decision-offer-budget-available"
}
}
}
activeSalesChannels
Type: [SalesChannelType]
URL: https://api.oeg-kraken.energy/v1/graphql/
A list of active sales channels.
The possible errors that can be raised are:
- KT-CT-12702: Invalid datetime range.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The datetime from which to filter active sales channels. |
|
The datetime up to which to filter active sales channels. |
Query
query ActiveSalesChannels(
$activeFrom: DateTime,
$activeTo: DateTime
) {
activeSalesChannels(
activeFrom: $activeFrom,
activeTo: $activeTo
) {
code
description
hierarchicalName
name
}
}
Variables
{
"activeFrom": "1988-10-24T23:29:47.787145+00:00",
"activeTo": "2019-06-28T23:12:59.469639+00:00"
}
Response
{
"data": {
"activeSalesChannels": [
{
"code": "election-book-green-bank-offer",
"description": "level-but-top-begin-lead",
"hierarchicalName": "upon-follow-decade-reveal-able",
"name": "third-call-their-accept-leader"
}
]
}
}
Arguments
| Name | Description |
|---|---|
|
The market brand code. |
|
The date when product must be available. |
Query
query ActiveTariffs(
$brandCode: String,
$date: Date
) {
activeTariffs(
brandCode: $brandCode,
date: $date
) {
electricityTariffs {
...ProductFragment
}
gasTariffs {
...ProductFragment
}
}
}
Variables
{
"brandCode": "attorney-other-arm-yard-it",
"date": "2024-03-27"
}
affiliateLink
Type: AffiliateLinkType!
URL: https://api.oeg-kraken.energy/v1/graphql/
Link object for an affiliate organization.
The possible errors that can be raised are:
- KT-CT-7713: Invalid data.
- KT-CT-7718: Affiliate link is expired.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The affiliate link subdomain. |
Query
query AffiliateLink($subdomain: String!) {
affiliateLink(subdomain: $subdomain) {
contactEmail
contactName
id
isBusiness
landingUrl
organisation {
...AffiliateOrganisationTypeFragment
}
subdomain
trainingStatus
}
}
Variables
{
"subdomain": "occur-factor-institution-create-officer"
}
Response
{
"data": {
"affiliateLink": {
"contactEmail": "half-picture-serious-effort-statement",
"contactName": "hope-hold-present-surface-yard",
"id": "55599245",
"isBusiness": true,
"landingUrl": "try-process-plan-artist-poor",
"organisation": AffiliateOrganisationType,
"subdomain": "country-month-laugh-crime-young",
"trainingStatus": "NOT_APPLICABLE"
}
}
}
affiliateLinks
Type: [AffiliateLinkType!]!
URL: https://api.oeg-kraken.energy/v1/graphql/
Links (urls) for the affiliate organizations.
Arguments
| Name | Description |
|---|---|
|
Email address of the affiliate agent. |
Query
query AffiliateLinks($agentContactEmail: String!) {
affiliateLinks(agentContactEmail: $agentContactEmail) {
contactEmail
contactName
id
isBusiness
landingUrl
organisation {
...AffiliateOrganisationTypeFragment
}
subdomain
trainingStatus
}
}
Variables
{
"agentContactEmail": "challenge-couple-tonight-offer-accept"
}
Response
{
"data": {
"affiliateLinks": [
{
"contactEmail": "poor-heavy-drug-about-mission",
"contactName": "Congress-force-single-oil-everybody",
"id": "60296955",
"isBusiness": true,
"landingUrl": "affect-partner-professional-growth-home",
"organisation": AffiliateOrganisationType,
"subdomain": "education-including-nothing-challenge-media",
"trainingStatus": "NOT_APPLICABLE"
}
]
}
}
affiliateOrganisation
Type: AffiliateOrganisationType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return the details of a given affiliate organization, if any exists.
The possible errors that can be raised are:
- KT-CT-7701: The affiliate organisation was not found.
- KT-CT-7702: Either id or number must be provided.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The affiliate organisation ID. |
|
The affiliate organisation number. |
Query
query AffiliateOrganisation(
$id: Int,
$number: String
) {
affiliateOrganisation(
id: $id,
number: $number
) {
allowAlternativePaymentMethods
canRegisterBusinessMeterPoints
canRegisterCustomersWithoutEmailAddress
canRegisterPortfolioAccounts
canRenewTariffs
canUseIvrSupportApi
contactEmail
defaultAccountType
id
isFieldSalesOnlyProduct
name
number
salesChannelCode
skipMeterPointAddressValidation
}
}
Variables
{
"id": 46342617,
"number": "yes-truth-line-piece-family"
}
Response
{
"data": {
"affiliateOrganisation": {
"allowAlternativePaymentMethods": true,
"canRegisterBusinessMeterPoints": true,
"canRegisterCustomersWithoutEmailAddress": true,
"canRegisterPortfolioAccounts": true,
"canRenewTariffs": true,
"canUseIvrSupportApi": true,
"contactEmail": "ground-me-must-fear-fight",
"defaultAccountType": "BUSINESS",
"id": "94888208",
"isFieldSalesOnlyProduct": true,
"name": "raise-or-term-yeah-whatever",
"number": "change-oil-budget-between-again",
"salesChannelCode": "down-special-for-speak-modern",
"skipMeterPointAddressValidation": true
}
}
}
agentCallCenterStatus
Type: AgentCallCenterStatusType!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the call center status for a given agent.
The possible errors that can be raised are:
- KT-CT-7813: Support user not found with that username.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The support user name. |
Query
query AgentCallCenterStatus($supportUserName: String!) {
agentCallCenterStatus(supportUserName: $supportUserName) {
id
mostRecentCallId
status
updatedAt
}
}
Variables
{
"supportUserName": "thank-including-both-stay-consumer"
}
Response
{
"data": {
"agentCallCenterStatus": {
"id": "79398862",
"mostRecentCallId": 55884379,
"status": "herself-account-opportunity-authority-I",
"updatedAt": "1974-10-05T01:31:54.148067+00:00"
}
}
}
Arguments
| Name | Description |
|---|---|
|
The agreement Kraken ID. |
Query
query Agreement($id: ID!) {
agreement(id: $id) {
account {
...AccountTypeFragment
}
agreedAt
agreedFrom
agreedTo
characteristicValues {
...CharacteristicValueInterfaceFragment
}
id
isActive
isRevoked
params
product {
...SupplyProductTypeFragment
}
rescissionDeadlineAt
supplyPoint {
...SupplyPointTypeFragment
}
terminatedAt
validFrom
validTo
}
}
Variables
{
"id": "73109890"
}
Response
{
"data": {
"agreement": {
"account": AccountType,
"agreedAt": "2014-09-06T00:53:01.086877+00:00",
"agreedFrom": "1999-05-18T13:37:24.192676+00:00",
"agreedTo": "2025-12-18T20:31:14.077563+00:00",
"characteristicValues": CharacteristicValueInterface,
"id": "77499321",
"isActive": true,
"isRevoked": true,
"params": {"key": "value"},
"product": SupplyProductType,
"rescissionDeadlineAt": "1991-02-22T18:00:24.235274+00:00",
"supplyPoint": SupplyPointType,
"terminatedAt": "2013-03-17T08:11:23.266349+00:00",
"validFrom": "1975-10-04T16:30:02.286741+00:00",
"validTo": "2021-08-25T05:10:30.454197+00:00"
}
}
}
agreementRollover
Type: AgreementRolloverType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get an agreement rollover by its number.
The possible errors that can be raised are:
- KT-CT-13705: Agreement rollover not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Number of the agreement rollover. |
Query
query AgreementRollover($number: String!) {
agreementRollover(number: $number) {
actualSendDate
agreement {
...CommonAgreementTypeFragment
}
createdAt
expectedSendDate
failureReason
id
number
params
quoteRequests {
...MarketSupplyQuoteRequestTypeFragment
}
rolledOnTo {
...CommonAgreementTypeFragment
}
rolloverType
status
suppressComms
tags
updatedAt
}
}
Variables
{
"number": "interview-window-practice-government-meet"
}
Response
{
"data": {
"agreementRollover": {
"actualSendDate": "1994-05-31",
"agreement": CommonAgreementType,
"createdAt": "1991-08-05T04:24:54.861190+00:00",
"expectedSendDate": "1984-06-27",
"failureReason": "allow-discussion-bill-class-little",
"id": "91513151",
"number": "American-stop-young-soon-friend",
"params": {"key": "value"},
"quoteRequests": MarketSupplyQuoteRequestType,
"rolledOnTo": CommonAgreementType,
"rolloverType": "DEFAULT",
"status": "PENDING",
"suppressComms": true,
"tags": ["weight-increase-third-not-develop"],
"updatedAt": "1979-08-10T09:28:05.940000+00:00"
}
}
}
agreementsForRollover
Type: [CommonAgreementType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get agreements eligible for the rollover process.
Arguments
| Name | Description |
|---|---|
|
Days before the agreement expiration. |
|
Window size in days. |
Query
query AgreementsForRollover(
$daysBeforeExpiration: Int!,
$windowSize: Int!
) {
agreementsForRollover(
daysBeforeExpiration: $daysBeforeExpiration,
windowSize: $windowSize
) {
account {
...AccountTypeFragment
}
agreedAt
agreedFrom
agreedTo
characteristicValues {
...CharacteristicValueInterfaceFragment
}
id
isActive
isRevoked
params
product {
...SupplyProductTypeFragment
}
rescissionDeadlineAt
supplyPoint {
...SupplyPointTypeFragment
}
terminatedAt
validFrom
validTo
}
}
Variables
{
"daysBeforeExpiration": 24,
"windowSize": 97
}
Response
{
"data": {
"agreementsForRollover": [
{
"account": AccountType,
"agreedAt": "2021-06-28T02:58:13.912117+00:00",
"agreedFrom": "1976-08-17T13:25:07.767672+00:00",
"agreedTo": "1998-11-11T07:09:55.779561+00:00",
"characteristicValues": CharacteristicValueInterface,
"id": "29155531",
"isActive": true,
"isRevoked": true,
"params": {"key": "value"},
"product": SupplyProductType,
"rescissionDeadlineAt": "1998-08-03T06:19:03.158374+00:00",
"supplyPoint": SupplyPointType,
"terminatedAt": "2014-05-29T01:06:53.013879+00:00",
"validFrom": "2006-01-03T23:06:43.431645+00:00",
"validTo": "2009-01-10T19:40:49.320773+00:00"
}
]
}
}
apiBrownouts
Type: APIBrownoutConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Get brownouts by status.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
Statuses to filter for. Otherwise return active and upcoming brownouts. |
|
Query
query ApiBrownouts(
$after: String,
$before: String,
$first: Int,
$input: APIBrownoutInput,
$last: Int
) {
apiBrownouts(
after: $after,
before: $before,
first: $first,
input: $input,
last: $last
) {
edgeCount
edges {
...APIBrownoutEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"input": APIBrownoutInput,
"last": 10
}
Response
{
"data": {
"apiBrownouts": {
"edgeCount": 77,
"edges": APIBrownoutEdge,
"pageInfo": PageInfo,
"totalCount": 74
}
}
}
apiExceptions
Type: APIExceptionConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a connection containing API Exceptions.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
Fields to filter for. Otherwise don't filter at all. |
|
Query
query ApiExceptions(
$after: String,
$before: String,
$first: Int,
$input: APIExceptionQueryInput,
$last: Int
) {
apiExceptions(
after: $after,
before: $before,
first: $first,
input: $input,
last: $last
) {
edgeCount
edges {
...APIExceptionConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"input": APIExceptionQueryInput,
"last": 10
}
Response
{
"data": {
"apiExceptions": {
"edgeCount": 18,
"edges": APIExceptionConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 28
}
}
}
appSessions
Type: AppSessionConnectionTypeConnection!
URL: https://api.oeg-kraken.energy/v1/graphql/
App sessions recorded at the specified postcode or for the specified affiliate link subdomain.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
The postcode of the address at which the app session was recorded. |
|
The affiliate link subdomain to filter app sessions by. |
Query
query AppSessions(
$after: String,
$before: String,
$first: Int,
$last: Int,
$postcode: String,
$subdomain: String
) {
appSessions(
after: $after,
before: $before,
first: $first,
last: $last,
postcode: $postcode,
subdomain: $subdomain
) {
edgeCount
edges {
...AppSessionConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"postcode": "central-out-open-glass-perhaps",
"subdomain": "appear-coach-chair-situation-country"
}
Response
{
"data": {
"appSessions": {
"edgeCount": 25,
"edges": AppSessionConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 2
}
}
}
authorizedApplications
Type: [AuthorizedApplication]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all the confidential-client applications the current user has authorized.
Query
query AuthorizedApplications {
authorizedApplications {
clientId
name
}
}
Response
{
"data": {
"authorizedApplications": [
{
"clientId": "10551652",
"name": "anyone-thought-available-environment-reveal"
}
]
}
}
availableOfferings
Type: [OfferingType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a list of actively available offerings from the catalog.
Query
query AvailableOfferings {
availableOfferings {
customerDescription
customerName
groups {
...GroupTypeFragment
}
identifier
internalName
isActive
isAmendable
isDraft
isExpired
isFirstDraft
isLatestVersion
isSellable
lifecycle {
...LifecycleTypeFragment
}
offeringComponents {
...OfferingComponentTypeFragment
}
productComponents {
...ProductComponentTypeFragment
}
tags {
...TagTypeFragment
}
termTemplateComponents {
...TermTemplateComponentTypeFragment
}
}
}
Response
{
"data": {
"availableOfferings": [
{
"customerDescription": "understand-run-often-decade-foreign",
"customerName": "turn-budget-color-share-analysis",
"groups": [GroupType],
"identifier": "97990178",
"internalName": "play-key-at-former-say",
"isActive": true,
"isAmendable": true,
"isDraft": true,
"isExpired": true,
"isFirstDraft": true,
"isLatestVersion": true,
"isSellable": true,
"lifecycle": LifecycleType,
"offeringComponents": [OfferingComponentType],
"productComponents": [ProductComponentType],
"tags": [TagType],
"termTemplateComponents": [TermTemplateComponentType]
}
]
}
}
availableProductSwitchDates
Type: [Date]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get available dates for product switch.
The possible errors that can be raised are:
- KT-CT-1501: Agreement not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Agreement ID. |
|
The maximum number of days to look for available dates. |
Query
query AvailableProductSwitchDates(
$agreementId: Int!,
$maxRange: Int
) {
availableProductSwitchDates(
agreementId: $agreementId,
maxRange: $maxRange
)
}
Variables
{
"agreementId": 20448908,
"maxRange": 76
}
Response
{
"data": {
"availableProductSwitchDates": ["2012-01-04"]
}
}
availableProducts
Type: [SupplyProductType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get available products for the given market.
The possible errors that can be raised are:
- KT-CT-4930: Unsupported market.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Products available for the target market. |
Query
query AvailableProducts($marketName: String!) {
availableProducts(marketName: $marketName) {
availabilityStatus
availableFrom
availableTo
brandCode
code
description
displayName
endsAt
fullName
id
isHidden
marketName
notes
params
tags {
...SupplyProductTagTypeFragment
}
term
termsAndConditionsTypes {
...TermsAndConditionsTypeFragment
}
termsContractType
}
}
Variables
{
"marketName": "drop-the-range-candidate-value"
}
Response
{
"data": {
"availableProducts": [
{
"availabilityStatus": "EVERYONE",
"availableFrom": "1981-01-19T05:46:18.781626+00:00",
"availableTo": "2010-09-01T03:26:03.888159+00:00",
"brandCode": "shake-no-statement-view-level",
"code": "area-recent-according-effect-official",
"description": "travel-rest-thing-great-statement",
"displayName": "though-risk-bed-maybe-contain",
"endsAt": "1976-03-17T14:57:49.570536+00:00",
"fullName": "crime-simple-career-by-international",
"id": "90526977",
"isHidden": true,
"marketName": "sure-morning-off-lay-he",
"notes": "join-wall-no-miss-visit",
"params": {"key": "value"},
"tags": SupplyProductTagType,
"term": 84,
"termsAndConditionsTypes": TermsAndConditionsType,
"termsContractType": "sing-return-down-help-well"
}
]
}
}
backendScreen
Type: BackendScreenType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get mobile screen details to render.
The possible errors that can be raised are:
- KT-CT-8001: No backend screen available.
- KT-CT-8005: Backend screen does not support parameters.
- KT-CT-8008: Incorrect or missing data necessary to build the screen.
- KT-CT-8006: Error applying parameters to backend screen.
- KT-CT-8009: Error translating screen content.
- KT-CT-8010: Invalid step ID.
- KT-CT-8011: Cannot rewind past a previous irreversible step.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The maximum version of backend screens supported by the client. |
|
List of key-value pairs (strings) to pass as parameters to the screen. |
|
The ID of the screen to return. |
Query
query BackendScreen(
$maxVersionSupported: Int,
$params: [BackendScreenParamInputType],
$screenId: ID!
) {
backendScreen(
maxVersionSupported: $maxVersionSupported,
params: $params,
screenId: $screenId
) {
... on ComponentListType {
...ComponentListTypeFragment
}
... on Dashboard {
...DashboardFragment
}
... on FormScreenType {
...FormScreenTypeFragment
}
... on GenericBackendScreen {
...GenericBackendScreenFragment
}
}
}
Variables
{
"maxVersionSupported": 32,
"params": BackendScreenParamInputType,
"screenId": "83226407"
}
Response
{
"data": {
"backendScreen": ComponentListType
}
}
backendScreenEventIds
Type: [String]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all registered backend screen event IDs.
Query
query BackendScreenEventIds {
backendScreenEventIds
}
Response
{
"data": {
"backendScreenEventIds": ["size-physical-about-remain-learn"]
}
}
backendScreenIds
Type: [String]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all registered backend screen IDs.
Query
query BackendScreenIds {
backendScreenIds
}
Response
{
"data": {
"backendScreenIds": ["because-phone-number-after-seem"]
}
}
Arguments
| Name | Description |
|---|---|
|
The IBAN of the bank account. |
Query
query BankDetailsValidation($iban: NonEmptyString!) {
bankDetailsValidation(iban: $iban) {
areValid
message
}
}
Variables
{
"iban": "upon-thank-officer-second-establish"
}
Response
{
"data": {
"bankDetailsValidation": {
"areValid": true,
"message": "bring-message-marriage-yeah-lead"
}
}
}
bankHolidays
Type: [Date]
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns all German bank holidays for a specified year that are observed in one or more states.
Arguments
| Name | Description |
|---|---|
|
Query
query BankHolidays($year: Int!) {
bankHolidays(year: $year)
}
Variables
{
"year": 61
}
Response
{
"data": {
"bankHolidays": ["1993-09-17"]
}
}
bankTransferDetails
Type: BankTransferDetailsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the bank transfer details for customers to send monies.
Query
query BankTransferDetails {
bankTransferDetails {
accountHolder
bankName
bic
iban
paymentReference {
...BankTransferReferenceFragment
}
}
}
Response
{
"data": {
"bankTransferDetails": {
"accountHolder": "subject-attack-Democrat-quickly-us",
"bankName": "wonder-serious-well-increase-wait",
"bic": "memory-challenge-condition-difficult-special",
"iban": "arrive-attack-land-sport-despite",
"paymentReference": BankTransferReference
}
}
}
batteryDevice
Type: BatteryDeviceType
URL: https://api.oeg-kraken.energy/v1/graphql/
The currently active battery device.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'batteryDevice' field is deprecated.
Use `SmartFlexInverter` on `devices` query instead.
- Marked as deprecated on 2025-09-08.
- Scheduled for removal on or after 2026-03-01.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/676/
Query
query BatteryDevice(
$accountNumber: String!,
$propertyId: Int!
) {
batteryDevice(
accountNumber: $accountNumber,
propertyId: $propertyId
) {
chargingPreferences {
...BatteryChargingPreferencesTypeFragment
}
deviceStatus {
...DeviceStatusTypeFragment
}
deviceType
krakenflexDeviceId
params {
...BatteryParamsTypeFragment
}
provider
}
}
Variables
{
"accountNumber": "A-B1C29CA2",
"propertyId": 30802396
}
Response
{
"data": {
"batteryDevice": {
"chargingPreferences": BatteryChargingPreferencesType,
"deviceStatus": DeviceStatusType,
"deviceType": "BATTERIES",
"krakenflexDeviceId": "79921067",
"params": BatteryParamsType,
"provider": "BYD"
}
}
}
batteryVariants
Type: [BatteryVariantsType]
URL: https://api.oeg-kraken.energy/v1/graphql/
All supported batteries and their details.
Arguments
| Name | Description |
|---|---|
|
Only return batteries of a specific make. |
Query
query BatteryVariants($make: String) {
batteryVariants(make: $make) {
make
models {
...BatteryVariantModelsTypeFragment
}
}
}
Variables
{
"make": "high-local-run-upon-partner"
}
Response
{
"data": {
"batteryVariants": [
{
"make": "line-energy-soldier-fact-within",
"models": [BatteryVariantModelsType]
}
]
}
}
business
Type: BusinessType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about a business.
The possible errors that can be raised are:
- KT-CT-11101: The viewer is not authorized to execute the query/mutation. Check the ownership/permissions of provided data.
- KT-CT-11107: Unauthorized.
- KT-CT-1605: Invalid input.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
List of business detail key-value pairs to filter by. |
|
The business ID. |
Query
query Business(
$details: [BusinessDetailInput],
$id: ID
) {
business(
details: $details,
id: $id
) {
billingAddress {
...RichAddressTypeFragment
}
businessType
details {
...BusinessDetailTypeFragment
}
id
legalAddress {
...RichAddressTypeFragment
}
linkedAccountNumbers
name
number
paymentMethods {
...PaymentInstructionConnectionTypeConnectionFragment
}
sectors
segmentName
}
}
Variables
{
"details": BusinessDetailInput,
"id": "16245768"
}
Response
{
"data": {
"business": {
"billingAddress": RichAddressType,
"businessType": "SOLE_TRADER",
"details": [BusinessDetailType],
"id": "22623059",
"legalAddress": RichAddressType,
"linkedAccountNumbers": "35404520",
"name": "own-with-hold-article-address",
"number": "later-draw-peace-ground-manager",
"paymentMethods": PaymentInstructionConnectionTypeConnection,
"sectors": None,
"segmentName": "every-must-fly-much-operation"
}
}
}
businessAccountReferralRewardScheme
Type: ReferralSchemeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return a business referral reward scheme for the given account referral code.
Arguments
| Name | Description |
|---|---|
|
Friend referral code. |
Query
query BusinessAccountReferralRewardScheme($code: String!) {
businessAccountReferralRewardScheme(code: $code) {
canBeReferred
code
combinedRewardAmount
isUsageAtCapacity
loyaltyPointsBonus
maxRecurrence
referralDisplayUrl
referralUrl
referredRewardAmount
referrerGivenName
referrerRewardAmount
schemeType
}
}
Variables
{
"code": "onto-national-learn-human-fish"
}
Response
{
"data": {
"businessAccountReferralRewardScheme": {
"canBeReferred": true,
"code": "best-again-ready-girl-son",
"combinedRewardAmount": 21,
"isUsageAtCapacity": true,
"loyaltyPointsBonus": 16,
"maxRecurrence": 10,
"referralDisplayUrl": "crime-window-reveal-live-second",
"referralUrl": "office-anything-pull-cost-father",
"referredRewardAmount": 62,
"referrerGivenName": "James",
"referrerRewardAmount": 19,
"schemeType": "significant-picture-light-bad-always"
}
}
}
businessContract
Type: Contract
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about an account contract.
The possible errors that can be raised are:
- KT-CT-10003: Contract not found.
- KT-CT-10005: Missing required parameter: either identifier or accountNumber must be provided.
- KT-CT-10006: Account not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number to find the business contract for. |
|
The identifier of the contract. |
|
The version of the contract. |
Query
query BusinessContract(
$accountNumber: String,
$identifier: String,
$version: Int
) {
businessContract(
accountNumber: $accountNumber,
identifier: $identifier,
version: $version
) {
cancelledAt
identifier
lifecycle {
...ContractVersionFragment
}
party {
... on AccountType {
...AccountTypeFragment
}
... on BusinessType {
...BusinessTypeFragment
}
}
signedAt
status
subject {
...AccountTypeFragment
}
terms {
...TermInterfaceFragment
}
title
validFrom
validTo
}
}
Variables
{
"accountNumber": "A-F5D65657",
"identifier": "50297146",
"version": 46
}
Response
{
"data": {
"businessContract": {
"cancelledAt": "2001-05-25T20:04:37.289387+00:00",
"identifier": "50663532",
"lifecycle": ContractVersion,
"party": AccountType,
"signedAt": "1984-08-28T15:43:44.505361+00:00",
"status": "REVOKED",
"subject": [AccountType],
"terms": TermInterface,
"title": "style-possible-information-try-house",
"validFrom": "2001-01-25T18:18:48.618563+00:00",
"validTo": "1971-04-28T17:29:53.877990+00:00"
}
}
}
call
Type: CallInterface!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a call for a given ID.
The possible errors that can be raised are:
- KT-CT-11802: Call not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The call ID. |
Query
query Call($id: ID!) {
call(id: $id) {
account {
...AccountTypeFragment
}
id
metadata {
...CallMetadataItemTypeFragment
}
}
}
Variables
{
"id": "16088152"
}
Response
{
"data": {
"call": {
"account": AccountType,
"id": "37326289",
"metadata": CallMetadataItemType
}
}
}
callTag
Type: CallTagType!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the call tag for a given ID.
The possible errors that can be raised are:
- KT-CT-11809: Call tag not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The call tag ID. |
Query
query CallTag($id: ID!) {
callTag(id: $id) {
id
isActive
name
}
}
Variables
{
"id": "87388992"
}
Response
{
"data": {
"callTag": {
"id": "94179703",
"isActive": true,
"name": "him-plan-surface-fast-I"
}
}
}
callTags
Type: CallTagConnectionTypeConnection!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get call tags.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
Filter by active status. |
|
|
|
Filter by call tag name. |
Query
query CallTags(
$after: String,
$before: String,
$first: Int,
$isActive: Boolean,
$last: Int,
$name: String
) {
callTags(
after: $after,
before: $before,
first: $first,
isActive: $isActive,
last: $last,
name: $name
) {
edgeCount
edges {
...CallTagConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"isActive": true,
"last": 10,
"name": "its-drive-ahead-wife-lay"
}
Response
{
"data": {
"callTags": {
"edgeCount": 76,
"edges": CallTagConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 34
}
}
}
campaigns
Type: AccountCampaignConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
The campaigns associated with this account.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
|
|
|
|
|
|
Query
query Campaigns(
$accountNumber: String!,
$after: String,
$before: String,
$first: Int,
$last: Int
) {
campaigns(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last
) {
edgeCount
edges {
...AccountCampaignConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-47E90158",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10
}
Response
{
"data": {
"campaigns": {
"edgeCount": 93,
"edges": AccountCampaignConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 54
}
}
}
canRescindAgreement
Type: Boolean
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if an agreement can be rescinded.
The possible errors that can be raised are:
- KT-CT-1501: Agreement not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The ID of the agreement to check. |
Query
query CanRescindAgreement($agreementId: Int!) {
canRescindAgreement(agreementId: $agreementId)
}
Variables
{
"agreementId": 55693002
}
Response
{
"data": {
"canRescindAgreement": true
}
}
chargePointVariants
Type: [ChargePointVariantType]
URL: https://api.oeg-kraken.energy/v1/graphql/
All charge points variants.
Query
query ChargePointVariants {
chargePointVariants {
make
models {
...ChargePointVariantModelTypeFragment
}
}
}
Response
{
"data": {
"chargePointVariants": [
{
"make": "back-organization-research-individual-game",
"models": [ChargePointVariantModelType]
}
]
}
}
cityByPostcode
Type: String
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns the respective city of a given postcode. An invalid postcode will return an empty string.
Arguments
| Name | Description |
|---|---|
|
Query
query CityByPostcode($postcode: String!) {
cityByPostcode(postcode: $postcode)
}
Variables
{
"postcode": "decade-car-PM-production-skin"
}
Response
{
"data": {
"cityByPostcode": "him-movement-agency-discuss-manage"
}
}
collectionProcessDetails
Type: CollectionProcessDetailsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Collection process record details.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-11201: No Collection Process Records associated with id.
- KT-CT-11206: Unable to retrieve disconnection related data for collection process.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The collection process record number. |
Query
query CollectionProcessDetails($collectionProcessRecordNumber: String!) {
collectionProcessDetails(collectionProcessRecordNumber: $collectionProcessRecordNumber) {
associatedItems {
...CollectionProcessRecordAssociatedItemTypeFragment
}
collectionProcessRecordNumber
collectionProcessType
completionType
isActive
isComplete
isPaused
pausedDays
targetObjectIdentifier
}
}
Variables
{
"collectionProcessRecordNumber": "dream-environmental-toward-many-author"
}
Response
{
"data": {
"collectionProcessDetails": {
"associatedItems": [CollectionProcessRecordAssociatedItemType],
"collectionProcessRecordNumber": "accept-style-garden-discussion-let",
"collectionProcessType": "ACCOUNT",
"completionType": "place-everybody-consider-modern-without",
"isActive": true,
"isComplete": true,
"isPaused": true,
"pausedDays": 76,
"targetObjectIdentifier": "70734102"
}
}
}
collectiveWinterWorkout
Type: WinterWorkoutType
URL: https://api.oeg-kraken.energy/v1/graphql/
Statistics about the combined weekly and total gas savings of all Winter Workout participants.
Note that the targetSavingsRatio will always be zero for these combined values.
The possible errors that can be raised are:
- KT-CT-3956: Temporary error occurred.
- KT-CT-1113: Disabled GraphQL field requested.
Query
query CollectiveWinterWorkout {
collectiveWinterWorkout {
total {
...WinterWorkoutPeriodTypeFragment
}
weeks {
...WinterWorkoutPeriodTypeFragment
}
}
}
Response
{
"data": {
"collectiveWinterWorkout": {
"total": WinterWorkoutPeriodType,
"weeks": WinterWorkoutPeriodType
}
}
}
complaint
Type: ComplaintType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a complaint.
The possible errors that can be raised are:
- KT-CT-12301: Complaint not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query Complaint($complaintId: Int!) {
complaint(complaintId: $complaintId) {
assigneeId
contacts {
...ComplaintContactConnectionTypeConnectionFragment
}
creationDate
id
resolutionDate
subtype
type
}
}
Variables
{
"complaintId": 83933998
}
Response
{
"data": {
"complaint": {
"assigneeId": "90357125",
"contacts": ComplaintContactConnectionTypeConnection,
"creationDate": "1991-10-26",
"id": "74636534",
"resolutionDate": "1977-12-04",
"subtype": "Mrs-start-fear-page-investment",
"type": "magazine-Mr-specific-worker-hit"
}
}
}
completedDispatches
Type: [UpsideDispatchType]
URL: https://api.oeg-kraken.energy/v1/graphql/
All completed device dispatches 12 hours behind, in reverse time order.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-4341: Unable to fetch completed dispatches.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query CompletedDispatches($accountNumber: String!) {
completedDispatches(accountNumber: $accountNumber) {
delta
end
meta {
...UpsideDispatchMetaTypeFragment
}
start
}
}
Variables
{
"accountNumber": "A-5E082072"
}
Response
{
"data": {
"completedDispatches": [
{
"delta": "1.0",
"end": "2014-12-01T04:17:55.202850+00:00",
"meta": UpsideDispatchMetaType,
"start": "2011-05-22T13:04:58.446151+00:00"
}
]
}
}
consentTypes
Type: [ConsentTypeType]
URL: https://api.oeg-kraken.energy/v1/graphql/
A list of the consent types available.
Query
query ConsentTypes {
consentTypes {
code
defaultValue
description
name
}
}
Response
{
"data": {
"consentTypes": [
{
"code": "send-time-magazine-wife-everybody",
"defaultValue": "ACCEPTED",
"description": "rich-parent-hotel-stage-item",
"name": "month-ten-officer-matter-since"
}
]
}
}
contractCreationJourney
Type: ContractCreationJourneyType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about a contract creation journey.
The possible errors that can be raised are:
- KT-CT-10017: The contract journey could not be found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The number of the contract journey. |
Query
query ContractCreationJourney($number: String!) {
contractCreationJourney(number: $number) {
context {
...ContractCreationContextFragment
}
contractDetails {
...ContractDetailsFragment
}
journeyType
number
orderReference
requestedAt
status
}
}
Variables
{
"number": "wonder-investment-the-ground-kid"
}
Response
{
"data": {
"contractCreationJourney": {
"context": ContractCreationContext,
"contractDetails": ContractDetails,
"journeyType": "CONTRACT_CREATION",
"number": "American-matter-present-soon-leader",
"orderReference": "media-set-half-well-say",
"requestedAt": "1986-09-26T11:23:11.544250+00:00",
"status": "IN_PROGRESS"
}
}
}
contractNoteReasons
Type: [ContractNoteReasonType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a list of contract note reasons, optionally filtered by activity types.
Arguments
| Name | Description |
|---|---|
|
Filter reasons applicable to any of the given contract activity types. |
Query
query ContractNoteReasons($activityTypes: [ContractActivityTypeOptions]) {
contractNoteReasons(activityTypes: $activityTypes) {
activityTypes
description
slug
}
}
Variables
{
"activityTypes": "ALL_ACTIVITY_TYPES"
}
Response
{
"data": {
"contractNoteReasons": [
{
"activityTypes": "ALL_ACTIVITY_TYPES",
"description": "sort-message-itself-certain-remember",
"slug": "morning-choice-laugh-hard-world"
}
]
}
}
contracts
Type: [Contract]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a list of contracts filtered by party or subject.
The possible errors that can be raised are:
- KT-CT-10029: Missing contract filters.
- KT-CT-10030: Filter by subject is not implemented.
- KT-CT-10031: Invalid party filter.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Filters to apply when querying contracts. At least one filter must be provided. |
Query
query Contracts($filters: ContractFiltersInput!) {
contracts(filters: $filters) {
cancelledAt
identifier
lifecycle {
...ContractVersionFragment
}
party {
... on AccountType {
...AccountTypeFragment
}
... on BusinessType {
...BusinessTypeFragment
}
}
signedAt
status
subject {
...AccountTypeFragment
}
terms {
...TermInterfaceFragment
}
title
validFrom
validTo
}
}
Variables
{
"filters": ContractFiltersInput
}
Response
{
"data": {
"contracts": [
{
"cancelledAt": "1972-11-28T01:04:24.091501+00:00",
"identifier": "85874011",
"lifecycle": ContractVersion,
"party": AccountType,
"signedAt": "1972-04-12T17:18:15.549109+00:00",
"status": "REVOKED",
"subject": [AccountType],
"terms": TermInterface,
"title": "staff-these-capital-image-front",
"validFrom": "1998-11-02T10:45:34.494879+00:00",
"validTo": "2009-08-22T06:51:31.306229+00:00"
}
]
}
}
contributionSchemes
Type: [ContributionSchemeType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get contribution schemes.
Query
query ContributionSchemes {
contributionSchemes {
acceptingContributions
code
displayName
id
taxable
}
}
Response
{
"data": {
"contributionSchemes": [
{
"acceptingContributions": true,
"code": "central-suggest-pass-policy-number",
"displayName": "person-though-hard-discuss-then",
"id": "65723888",
"taxable": true
}
]
}
}
costOfCharge
Type: [CostOfChargeType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Aggregated cost of charge for an EV device.
The possible errors that can be raised are:
- KT-CT-4326: Could not get consumption cost data.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'costOfCharge' field is deprecated.
Use `cost` field on `SmartFlexChargingSession` instead.
- Marked as deprecated on 2025-05-13.
- Scheduled for removal on or after 2026-01-16.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/605/
Arguments
| Name | Description |
|---|---|
|
|
|
Frequency by day, week, month or year. |
|
The start date of the results required. Overrides report date (end date) if provided. |
Query
query CostOfCharge(
$accountNumber: String!,
$frequency: DataFrequency!,
$startDate: Date
) {
costOfCharge(
accountNumber: $accountNumber,
frequency: $frequency,
startDate: $startDate
) {
costOfChargeId
isSmartCharge
krakenflexDeviceId
reportDate
totalConsumption
totalCostExclTax
totalCostInclTax
}
}
Variables
{
"accountNumber": "A-B41A545B",
"frequency": "DAILY",
"startDate": "2019-08-10"
}
Response
{
"data": {
"costOfCharge": [
{
"costOfChargeId": "18049257",
"isSmartCharge": true,
"krakenflexDeviceId": "36638666",
"reportDate": "1994-06-16",
"totalConsumption": 489.12,
"totalCostExclTax": 783.21,
"totalCostInclTax": 422.2
}
]
}
}
customerFeedbackForms
Type: CustomerFeedbackFormConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns all active customer feedback forms for the account's brand.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
|
|
|
|
Feedback sources currently supported. |
|
|
|
Query
query CustomerFeedbackForms(
$accountNumber: String!,
$after: String,
$before: String,
$feedbackSource: CustomerFeedbackSourceChoices,
$first: Int,
$last: Int
) {
customerFeedbackForms(
accountNumber: $accountNumber,
after: $after,
before: $before,
feedbackSource: $feedbackSource,
first: $first,
last: $last
) {
edgeCount
edges {
...CustomerFeedbackFormConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-8E5D3DE7",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"feedbackSource": "FEEDBACK_SOURCE_PHONE_CALL_FOLLOW_UP",
"first": 10,
"last": 10
}
Response
{
"data": {
"customerFeedbackForms": {
"edgeCount": 99,
"edges": CustomerFeedbackFormConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 96
}
}
}
dashboardScreen
Type: Dashboard
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a dashboard screen to render in the form of a json list of sections containing cards or grouped cards each with an order attribute.
The possible errors that can be raised are:
- KT-CT-3820: Received both ledger ID and number.
- KT-CT-8001: No backend screen available.
- KT-CT-8005: Backend screen does not support parameters.
- KT-CT-8008: Incorrect or missing data necessary to build the screen.
- KT-CT-8006: Error applying parameters to backend screen.
- KT-CT-8009: Error translating screen content.
- KT-CT-8010: Invalid step ID.
- KT-CT-8011: Cannot rewind past a previous irreversible step.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number of the user. |
|
The ID of the dashboard type screen to return. |
|
The ledger number associated to the account. |
|
The maximum version of dahshboard type screens supported by the client. |
|
List of key-value pairs (strings) to pass as parameters to the screen. |
|
The property id associated to the account. |
Query
query DashboardScreen(
$accountNumber: String!,
$dashboardId: ID!,
$ledgerNumber: String,
$maxVersionSupported: Int!,
$params: [BackendScreenParamInputType],
$propertyId: String
) {
dashboardScreen(
accountNumber: $accountNumber,
dashboardId: $dashboardId,
ledgerNumber: $ledgerNumber,
maxVersionSupported: $maxVersionSupported,
params: $params,
propertyId: $propertyId
) {
dashboardItems {
...SectionTypeFragment
}
id
serialisedDashboardItems
typename
}
}
Variables
{
"accountNumber": "A-9B61FF58",
"dashboardId": "59298155",
"ledgerNumber": "draw-this-common-beyond-win",
"maxVersionSupported": 26,
"params": BackendScreenParamInputType,
"propertyId": "12262208"
}
Response
{
"data": {
"dashboardScreen": {
"dashboardItems": SectionType,
"id": "70355190",
"serialisedDashboardItems": "job-financial-section-behavior-movie",
"typename": "debate-material-American-need-work"
}
}
}
defaultElectricitySuppliers
Type: [DefaultElectricitySupplierType!]
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns the default electricity suppliers and their tariffs for a given postcode from the getAG API.
Note that there is usually only one default supplier for a given postcode, but there may be multiple default suppliers for some postcodes.
Arguments
| Name | Description |
|---|---|
|
The customer's estimated annual electricity consumption in kWh. |
|
The customer's postcode. |
Query
query DefaultElectricitySuppliers(
$annualConsumption: Int!,
$postcode: String!
) {
defaultElectricitySuppliers(
annualConsumption: $annualConsumption,
postcode: $postcode
) {
supplierName
supplierNumber
tariffs {
...DefaultElectricitySupplierTariffTypeFragment
}
}
}
Variables
{
"annualConsumption": 13,
"postcode": "though-red-job-might-better"
}
Response
{
"data": {
"defaultElectricitySuppliers": [
{
"supplierName": "drug-offer-concern-grow-poor",
"supplierNumber": "organization-throw-item-network-instead",
"tariffs": DefaultElectricitySupplierTariffType
}
]
}
}
defaultPaymentInstruction
Type: PaymentInstructionType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the default payment instruction for the account's main ledger.
Deprecated
The 'defaultPaymentInstruction' field is deprecated.
Please use 'usablePaymentInstructions' on the Ledger type to get all usable instructions, or 'paymentPreferenceAtTime' on the Ledger type to get a specific one. Both require explicitly requesting a ledger.
- Marked as deprecated on 2026-01-28.
- Scheduled for removal on or after 2026-07-28.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
Provide an option to get either a CARD or DIRECT_DEBIT instruction. |
Query
query DefaultPaymentInstruction(
$accountNumber: String!,
$instructionType: PaymentType
) {
defaultPaymentInstruction(
accountNumber: $accountNumber,
instructionType: $instructionType
) {
accountHolder
accountType
bankCode
cardExpiryMonth
cardExpiryYear
cardNumber
cardPaymentNetwork
cardType
iban
id
instructionType
maskedAccountIdentifier
owners {
...PaymentInstructionOwnerTypeFragment
}
sortCode
status
supplementaryLedger {
...SupplementaryLedgerTypeFragment
}
validFrom
vendor
}
}
Variables
{
"accountNumber": "A-EB9774DF",
"instructionType": "BPAY"
}
Response
{
"data": {
"defaultPaymentInstruction": {
"accountHolder": "really-throughout-sign-vote-message",
"accountType": "hair-idea-fear-stand-for",
"bankCode": "different-growth-policy-at-another",
"cardExpiryMonth": 100,
"cardExpiryYear": 43,
"cardNumber": "ready-almost-modern-history-require",
"cardPaymentNetwork": "until-station-since-information-should",
"cardType": "local-side-west-event-prepare",
"iban": "write-mother-power-impact-matter",
"id": "28366428",
"instructionType": "court-agency-despite-recognize-enough",
"maskedAccountIdentifier": "30268965",
"owners": [PaymentInstructionOwnerType],
"sortCode": "worry-quite-piece-else-establish",
"status": "each-yet-one-prevent-ability",
"supplementaryLedger": SupplementaryLedgerType,
"validFrom": "1999-05-31T18:24:57.386924+00:00",
"vendor": "clearly-time-within-again-worker"
}
}
}
defaultRawScore
Type: Int
URL: https://api.oeg-kraken.energy/v1/graphql/
Get default raw score for a customer feedback form.
The possible errors that can be raised are:
- KT-CT-5513: Invalid data.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query DefaultRawScore($formId: Int!) {
defaultRawScore(formId: $formId)
}
Variables
{
"formId": 29587827
}
Response
{
"data": {
"defaultRawScore": 32
}
}
depositAgreements
Type: [DepositAgreementOutput]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get deposit agreements for a given account.
The possible errors that can be raised are:
- KT-CT-4177: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query DepositAgreements($accountNumber: String!) {
depositAgreements(accountNumber: $accountNumber) {
acceptedAt
collectionDate
currentEligibilityStatus {
...CurrentEligibilityStatusOutputFragment
}
depositAmount
depositKey
dueDate
fulfilledAt
returnStrategy
}
}
Variables
{
"accountNumber": "A-728989B6"
}
Response
{
"data": {
"depositAgreements": [
{
"acceptedAt": "2003-04-28T18:18:13.557380+00:00",
"collectionDate": "2023-06-17",
"currentEligibilityStatus": CurrentEligibilityStatusOutput,
"depositAmount": 95,
"depositKey": "paper-item-practice-fire-standard",
"dueDate": "2010-04-09",
"fulfilledAt": "2006-09-22T12:25:31.676124+00:00",
"returnStrategy": "third-budget-pressure-travel-phone"
}
]
}
}
devices
Type: [SmartFlexDeviceInterface!]
URL: https://api.oeg-kraken.energy/v1/graphql/
A list of devices registered to an account.
Arguments
| Name | Description |
|---|---|
|
The account number, e.g. A-12345678. |
|
Only list the device with this ID. |
|
Only list the device with this integration device ID. |
|
Only list devices registered to this property. |
Query
query Devices(
$accountNumber: String!,
$deviceId: String,
$integrationDeviceId: String,
$propertyId: ID
) {
devices(
accountNumber: $accountNumber,
deviceId: $deviceId,
integrationDeviceId: $integrationDeviceId,
propertyId: $propertyId
) {
alerts {
...SmartFlexDeviceAlertInterfaceFragment
}
deviceType
id
integrationDeviceId
name
onboardingWizard {
...SmartFlexOnboardingWizardFragment
}
preferenceSetting {
...FlexDevicePreferenceSettingInterfaceFragment
}
preferences {
...SmartFlexDevicePreferencesInterfaceFragment
}
propertyId
provider
reAuthenticationState {
...DeviceReAuthenticationInterfaceFragment
}
status {
...SmartFlexDeviceStatusInterfaceFragment
}
}
}
Variables
{
"accountNumber": "A-9E18010E",
"deviceId": "16748511",
"integrationDeviceId": "69740457",
"propertyId": "53183230"
}
Response
{
"data": {
"devices": [
{
"alerts": SmartFlexDeviceAlertInterface,
"deviceType": "BATTERIES",
"id": "84218885",
"integrationDeviceId": "60696610",
"name": "himself-because-tell-wish-energy",
"onboardingWizard": SmartFlexOnboardingWizard,
"preferenceSetting": FlexDevicePreferenceSettingInterface,
"preferences": SmartFlexDevicePreferencesInterface,
"propertyId": "34481670",
"provider": "BYD",
"reAuthenticationState": DeviceReAuthenticationInterface,
"status": SmartFlexDeviceStatusInterface
}
]
}
}
domesticAccountReferralRewardScheme
Type: ReferralSchemeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return a domestic referral reward scheme for the given account referral code.
Arguments
| Name | Description |
|---|---|
|
Friend referral code. |
Query
query DomesticAccountReferralRewardScheme($code: String!) {
domesticAccountReferralRewardScheme(code: $code) {
canBeReferred
code
combinedRewardAmount
isUsageAtCapacity
loyaltyPointsBonus
maxRecurrence
referralDisplayUrl
referralUrl
referredRewardAmount
referrerGivenName
referrerRewardAmount
schemeType
}
}
Variables
{
"code": "news-right-above-company-statement"
}
Response
{
"data": {
"domesticAccountReferralRewardScheme": {
"canBeReferred": true,
"code": "bank-artist-story-people-may",
"combinedRewardAmount": 39,
"isUsageAtCapacity": true,
"loyaltyPointsBonus": 62,
"maxRecurrence": 66,
"referralDisplayUrl": "degree-shoulder-nation-anything-three",
"referralUrl": "network-front-student-ago-red",
"referredRewardAmount": 63,
"referrerGivenName": "Joel",
"referrerRewardAmount": 58,
"schemeType": "today-participant-main-between-really"
}
}
}
domesticJoiningRewardScheme
Type: ReferralSchemeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return a joining reward scheme with the given code, if it's active. A joining reward can be a signup reward or a promotional reward.
Arguments
| Name | Description |
|---|---|
|
Reward code for the scheme. |
Query
query DomesticJoiningRewardScheme($code: String!) {
domesticJoiningRewardScheme(code: $code) {
canBeReferred
code
combinedRewardAmount
isUsageAtCapacity
loyaltyPointsBonus
maxRecurrence
referralDisplayUrl
referralUrl
referredRewardAmount
referrerGivenName
referrerRewardAmount
schemeType
}
}
Variables
{
"code": "happy-yet-need-but-third"
}
Response
{
"data": {
"domesticJoiningRewardScheme": {
"canBeReferred": true,
"code": "than-bank-defense-bring-another",
"combinedRewardAmount": 20,
"isUsageAtCapacity": true,
"loyaltyPointsBonus": 75,
"maxRecurrence": 32,
"referralDisplayUrl": "policy-international-several-worker-when",
"referralUrl": "sort-more-wonder-service-moment",
"referredRewardAmount": 44,
"referrerGivenName": "Mary",
"referrerRewardAmount": 58,
"schemeType": "final-team-civil-American-society"
}
}
}
domesticSignupRewardScheme
Type: ReferralSchemeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Return a signup referral reward scheme with the given code, if it's active.
Arguments
| Name | Description |
|---|---|
|
Reward code for the scheme. |
Query
query DomesticSignupRewardScheme($code: String!) {
domesticSignupRewardScheme(code: $code) {
canBeReferred
code
combinedRewardAmount
isUsageAtCapacity
loyaltyPointsBonus
maxRecurrence
referralDisplayUrl
referralUrl
referredRewardAmount
referrerGivenName
referrerRewardAmount
schemeType
}
}
Variables
{
"code": "however-big-black-run-somebody"
}
Response
{
"data": {
"domesticSignupRewardScheme": {
"canBeReferred": true,
"code": "then-question-reduce-thing-parent",
"combinedRewardAmount": 94,
"isUsageAtCapacity": true,
"loyaltyPointsBonus": 83,
"maxRecurrence": 27,
"referralDisplayUrl": "consider-billion-like-something-feel",
"referralUrl": "require-likely-style-school-mind",
"referredRewardAmount": 14,
"referrerGivenName": "John",
"referrerRewardAmount": 41,
"schemeType": "part-week-standard-natural-tonight"
}
}
}
electricVehicles
Type: [ElectricVehicleType]
URL: https://api.oeg-kraken.energy/v1/graphql/
All electric vehicle types and their details.
The possible errors that can be raised are:
- KT-CT-4343: Unable to fetch electric vehicles list for make.
- KT-CT-4344: Make is not supported by provider.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Only return vehicles that are currently integrated. |
|
Only return vehicle types for the specified make. |
|
Only return vehicle types supported by the specified provider, e.g. Tesla. |
Query
query ElectricVehicles(
$isIntegrationLive: Boolean,
$make: String,
$supportedProvider: ProviderChoices
) {
electricVehicles(
isIntegrationLive: $isIntegrationLive,
make: $make,
supportedProvider: $supportedProvider
) {
make
models {
...ElectricVehicleModelTypeFragment
}
}
}
Variables
{
"isIntegrationLive": true,
"make": "effort-girl-yet-wide-simply",
"supportedProvider": "BYD"
}
Response
{
"data": {
"electricVehicles": [
{
"make": "become-success-herself-let-trouble",
"models": [ElectricVehicleModelType]
}
]
}
}
electricityMeterReadings
Type: ElectricityMeterReadingConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch electricity meter readings for a given account and meter.
This field is a connection type. Connections are used to implement cursor based pagination.
This field requires the Authorization header to be set.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Only fetch meter readings made since this date |
|
Only fetch meter readings made until this date |
|
|
|
Query
query ElectricityMeterReadings(
$accountNumber: String!,
$after: String,
$before: String,
$first: Int,
$last: Int,
$meterId: ID!,
$readFrom: DateTime,
$readTo: DateTime,
$readingOrigins: [ReadingOrigin],
$typesOfRead: [TypeOfRead]
) {
electricityMeterReadings(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last,
meterId: $meterId,
readFrom: $readFrom,
readTo: $readTo,
readingOrigins: $readingOrigins,
typesOfRead: $typesOfRead
) {
edgeCount
edges {
...ElectricityMeterReadingConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-F5F7C30F",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"meterId": "13197779",
"readFrom": "2005-03-01T00:51:46.166790+00:00",
"readTo": "2023-02-16T16:52:47.040913+00:00",
"readingOrigins": "CUSTOMER",
"typesOfRead": "METER_INSTALLED"
}
Response
{
"data": {
"electricityMeterReadings": {
"edgeCount": 19,
"edges": ElectricityMeterReadingConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 55
}
}
}
electricityMeterReadingsByRegister
Type: ElectricityMeterForReadingType
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch electricity meter readings for a given account and meter, split up by register.
The possible errors that can be raised are:
- KT-CT-6420: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Query
query ElectricityMeterReadingsByRegister(
$accountNumber: String!,
$meterId: ID!
) {
electricityMeterReadingsByRegister(
accountNumber: $accountNumber,
meterId: $meterId
) {
registers {
...ElectricityRegisterForReadingTypeFragment
}
}
}
Variables
{
"accountNumber": "A-541623F2",
"meterId": "27072976"
}
Response
{
"data": {
"electricityMeterReadingsByRegister": {
"registers": [ElectricityRegisterForReadingType]
}
}
}
electricityMeters
Type: ElectricityMeterConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch electricity meters for a given account and MeLo.
This field is a connection type. Connections are used to implement cursor based pagination.
This field requires the Authorization header to be set.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Query
query ElectricityMeters(
$accountNumber: String!,
$after: String,
$before: String,
$first: Int,
$last: Int,
$meloNumber: String!
) {
electricityMeters(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last,
meloNumber: $meloNumber
) {
edgeCount
edges {
...ElectricityMeterConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-D7A6BCF0",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"meloNumber": "art-home-involve-believe-our"
}
Response
{
"data": {
"electricityMeters": {
"edgeCount": 62,
"edges": ElectricityMeterConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 77
}
}
}
electricitySuppliers
Type: [SupplierType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns all the electricity suppliers directly from the getAG API.
Query
query ElectricitySuppliers {
electricitySuppliers {
brandId
supplierId
supplierName
supplierNumber
}
}
Response
{
"data": {
"electricitySuppliers": [
{
"brandId": 66677296,
"supplierId": 45484426,
"supplierName": "meet-short-for-want-night",
"supplierNumber": "Mrs-employee-public-quality-no"
}
]
}
}
eligibilityToJoinLoyaltyPointsProgram
Type: LoyaltyPointsProgramEligibilityType
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if an account is eligible to join the loyalty points program.
The possible errors that can be raised are:
- KT-CT-9202: Loyalty Points adapter not configured.
- KT-CT-9218: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
Query
query EligibilityToJoinLoyaltyPointsProgram($input: LoyaltyPointsProgramEligibilityInput!) {
eligibilityToJoinLoyaltyPointsProgram(input: $input) {
isEligible
primaryIneligibilityReason
}
}
Variables
{
"input": LoyaltyPointsProgramEligibilityInput
}
Response
{
"data": {
"eligibilityToJoinLoyaltyPointsProgram": {
"isEligible": true,
"primaryIneligibilityReason": "able-compare-avoid-work-see"
}
}
}
eligibleDeviceTypes
Type: [KrakenFlexDeviceTypes]
URL: https://api.oeg-kraken.energy/v1/graphql/
A list of device types that are eligible for registration.
Arguments
| Name | Description |
|---|---|
|
The account number, e.g. A-12345678. |
|
|
Query
query EligibleDeviceTypes(
$accountNumber: String!,
$propertyId: Int
) {
eligibleDeviceTypes(
accountNumber: $accountNumber,
propertyId: $propertyId
)
}
Variables
{
"accountNumber": "A-8B667732",
"propertyId": 40438425
}
Response
{
"data": {
"eligibleDeviceTypes": "BATTERIES"
}
}
embeddedNetwork
Type: EmbeddedNetworkType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about an embedded network.
Arguments
| Name | Description |
|---|---|
|
Query
query EmbeddedNetwork($id: ID!) {
embeddedNetwork(id: $id) {
embeddedProperties {
...EmbeddedPropertyTypeFragment
}
id
name
}
}
Variables
{
"id": "22915122"
}
Response
{
"data": {
"embeddedNetwork": {
"embeddedProperties": [EmbeddedPropertyType],
"id": "21348447",
"name": "oil-then-sell-ok-remember"
}
}
}
energyMixData
Type: EnergyMixDataType
URL: https://api.oeg-kraken.energy/v1/graphql/
The current energy generation mix.
Query
query EnergyMixData {
energyMixData {
carbonIntensityIndex
}
}
Response
{
"data": {
"energyMixData": {
"carbonIntensityIndex": "recently-successful-help-dog-water"
}
}
}
enodeLinkSession
Type: EnodeLinkSessionType
URL: https://api.oeg-kraken.energy/v1/graphql/
The user specific Enode link session details.
The possible errors that can be raised are:
- KT-CT-4328: Invalid data.
- KT-CT-1111: Unauthorized.
- KT-CT-4319: Unable to get Enode link session.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'enodeLinkSession' field is deprecated.
Please use 'startSmartFlexOnboarding' instead.
- Marked as deprecated on 2025-10-30.
- Scheduled for removal on or after 2026-04-30.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/608/
Arguments
| Name | Description |
|---|---|
|
|
|
Query
query EnodeLinkSession(
$accountNumber: String,
$vendor: EnodeVendors
) {
enodeLinkSession(
accountNumber: $accountNumber,
vendor: $vendor
) {
linkState
linkUrl
}
}
Variables
{
"accountNumber": "A-3941D4AD",
"vendor": "AUDI"
}
Response
{
"data": {
"enodeLinkSession": {
"linkState": "run-above-case-girl-wait",
"linkUrl": "white-cut-according-people-during"
}
}
}
epexDayAheadPrices
Type: EpexDayAheadPriceConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Get EPEX Day Ahead electricity prices for Germany. Returns price data in 15-minute intervals for the specified time period. Prices are in EUR/MWh.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
End datetime for price data (exclusive). |
|
Start datetime for price data (inclusive). |
Query
query EpexDayAheadPrices(
$after: String,
$before: String,
$first: Int,
$last: Int,
$periodEnd: DateTime!,
$periodStart: DateTime!
) {
epexDayAheadPrices(
after: $after,
before: $before,
first: $first,
last: $last,
periodEnd: $periodEnd,
periodStart: $periodStart
) {
edgeCount
edges {
...EpexDayAheadPriceConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"periodEnd": "2011-03-17T19:50:07.885131+00:00",
"periodStart": "1975-06-16T07:14:00.538045+00:00"
}
Response
{
"data": {
"epexDayAheadPrices": {
"edgeCount": 48,
"edges": EpexDayAheadPriceConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 59
}
}
}
estimateMeterReadings
Type: MeterReadingEstimationReadingConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Estimated meter readings.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
The meter id to perform estimation on. |
|
|
|
|
|
This is the unique identifier used by the market to identify the supply point. |
|
The end of the period estimated. |
|
The start of the period estimated. |
|
The meter's register identifier. |
Query
query EstimateMeterReadings(
$after: String,
$before: String,
$deviceId: ID,
$first: Int,
$last: Int,
$marketIdentifier: ID!,
$periodEnd: DateTime!,
$periodStart: DateTime!,
$registerId: ID
) {
estimateMeterReadings(
after: $after,
before: $before,
deviceId: $deviceId,
first: $first,
last: $last,
marketIdentifier: $marketIdentifier,
periodEnd: $periodEnd,
periodStart: $periodStart,
registerId: $registerId
) {
edgeCount
edges {
...MeterReadingEstimationReadingEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"deviceId": "85212509",
"first": 10,
"last": 10,
"marketIdentifier": "11696538",
"periodEnd": "1985-08-11T06:12:58.102558+00:00",
"periodStart": "1972-09-12T15:00:44.022077+00:00",
"registerId": "16128778"
}
Response
{
"data": {
"estimateMeterReadings": {
"edgeCount": 16,
"edges": MeterReadingEstimationReadingEdge,
"pageInfo": PageInfo,
"totalCount": 92
}
}
}
estimatedElectricityConsumption
Type: Decimal
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch the estimated electricity consumption for a given MeLo at a given time period in kWh.
The possible errors that can be raised are:
- KT-DE-4710: Estimated consumption calculation failed.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
The end date (inclusive) for calculating the estimated electricity consumption. |
|
The MeLo number. |
|
The start date for calculating the estimated electricity consumption. |
Query
query EstimatedElectricityConsumption(
$accountNumber: String!,
$endDate: Date!,
$meloNumber: String!,
$startDate: Date!
) {
estimatedElectricityConsumption(
accountNumber: $accountNumber,
endDate: $endDate,
meloNumber: $meloNumber,
startDate: $startDate
)
}
Variables
{
"accountNumber": "A-F28687D9",
"endDate": "1984-11-20",
"meloNumber": "behind-catch-be-relate-herself",
"startDate": "1996-11-30"
}
Response
{
"data": {
"estimatedElectricityConsumption": "1.0"
}
}
estimatedGasConsumption
Type: Decimal
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch the estimated gas consumption for a given MeLo at a given time period in kWh.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
The end date (inclusive) for calculating the estimated gas consumption. |
|
The MeLo number. |
|
The start date for calculating the estimated gas consumption. |
Query
query EstimatedGasConsumption(
$accountNumber: String!,
$endDate: Date!,
$meloNumber: String!,
$startDate: Date!
) {
estimatedGasConsumption(
accountNumber: $accountNumber,
endDate: $endDate,
meloNumber: $meloNumber,
startDate: $startDate
)
}
Variables
{
"accountNumber": "A-EAAEC0AD",
"endDate": "2010-05-25",
"meloNumber": "simple-nice-hot-soon-sign",
"startDate": "1998-08-17"
}
Response
{
"data": {
"estimatedGasConsumption": "1.0"
}
}
externalAccountEvents
Type: ExternalAccountEventConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a list of audit account events, of type external, for a given account.
Arguments
| Name | Description |
|---|---|
|
Account number to filter by. |
|
|
|
|
|
|
|
Query
query ExternalAccountEvents(
$accountNumber: String!,
$after: String,
$before: String,
$first: Int,
$last: Int
) {
externalAccountEvents(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last
) {
edgeCount
edges {
...ExternalAccountEventConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-1D280078",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10
}
Response
{
"data": {
"externalAccountEvents": {
"edgeCount": 74,
"edges": ExternalAccountEventConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 27
}
}
}
fanClubStatus
Type: [FanClubStatus]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get current status, historic discounts and future projections for a Fan Club source.
The possible errors that can be raised are:
- KT-CT-6622: Unauthorized.
- KT-CT-4177: Unauthorized.
- KT-CT-8102: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
The ID of the property. |
Query
query FanClubStatus(
$accountNumber: String,
$propertyId: Int
) {
fanClubStatus(
accountNumber: $accountNumber,
propertyId: $propertyId
) {
accountNumbers
catchments
current {
...DiscountDataFragment
}
discountSource
forecast {
...DiscountForecastFragment
}
historic {
...DiscountDataFragment
}
location
name
propertyIds
thresholds {
...ThresholdFragment
}
windFarm
}
}
Variables
{
"accountNumber": "A-C113EBAC",
"propertyId": 54102995
}
Response
{
"data": {
"fanClubStatus": [
{
"accountNumbers": "nation-keep-reality-baby-work",
"catchments": "ever-artist-service-heavy-fine",
"current": DiscountData,
"discountSource": "collection-section-three-suggest-lose",
"forecast": DiscountForecast,
"historic": DiscountData,
"location": "little-when-situation-inside-seem",
"name": "bed-water-relationship-collection-garden",
"propertyIds": 53,
"thresholds": Threshold,
"windFarm": "surface-rate-campaign-food-possible"
}
]
}
}
flexPlannedDispatches
Type: [SmartFlexDispatch]
URL: https://api.oeg-kraken.energy/v1/graphql/
All planned device dispatches in time order.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-4340: Unable to fetch planned dispatches.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The SmartFlex device ID to get the planned dispatches for. |
Query
query FlexPlannedDispatches($deviceId: String!) {
flexPlannedDispatches(deviceId: $deviceId) {
end
energyAddedKwh
start
type
}
}
Variables
{
"deviceId": "14197122"
}
Response
{
"data": {
"flexPlannedDispatches": [
{
"end": "1976-08-26T02:06:31.508948+00:00",
"energyAddedKwh": "1.0",
"start": "2005-12-15T06:41:22.556733+00:00",
"type": "SMART"
}
]
}
}
flexSupportedDevices
Type: FlexSupportedDevices
URL: https://api.oeg-kraken.energy/v1/graphql/
Devices capable of being registered with SmartFlex.
Arguments
| Name | Description |
|---|---|
|
The device type to get the supported devices for. |
Query
query FlexSupportedDevices($deviceType: KrakenFlexDeviceTypes!) {
flexSupportedDevices(deviceType: $deviceType) {
deviceType
supportedMakes {
...FlexSupportedMakeFragment
}
}
}
Variables
{
"deviceType": "BATTERIES"
}
Response
{
"data": {
"flexSupportedDevices": {
"deviceType": "BATTERIES",
"supportedMakes": FlexSupportedMake
}
}
}
fraudMeterPointChecks
Type: FraudMeterPointCheckType
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if a given meter point ID is in suspicious meter point IDs list.
Arguments
| Name | Description |
|---|---|
|
The meter point ID. |
Query
query FraudMeterPointChecks($meterPointId: String!) {
fraudMeterPointChecks(meterPointId: $meterPointId) {
isInSuspiciousList
meterPointId
}
}
Variables
{
"meterPointId": "25970521"
}
Response
{
"data": {
"fraudMeterPointChecks": {
"isInSuspiciousList": true,
"meterPointId": "32323063"
}
}
}
fraudRiskLevel
Type: FinancialRiskLevelType
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if a given ID and type have a financial risk level.
Arguments
| Name | Description |
|---|---|
|
The type of object the ID represents. |
|
The ID to be checked. |
Query
query FraudRiskLevel(
$identifierType: String!,
$identifierValue: String!
) {
fraudRiskLevel(
identifierType: $identifierType,
identifierValue: $identifierValue
) {
identifierType
identifierValue
isInRiskList
riskLevel
}
}
Variables
{
"identifierType": "option-guess-stop-put-rich",
"identifierValue": "style-plan-ago-edge-north"
}
Response
{
"data": {
"fraudRiskLevel": {
"identifierType": "history-down-fund-take-choose",
"identifierValue": "23391179",
"isInRiskList": true,
"riskLevel": "1.0"
}
}
}
gasMeterReadings
Type: GasMeterReadingConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch gas meter readings for a given account and meter.
This field is a connection type. Connections are used to implement cursor based pagination.
This field requires the Authorization header to be set.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Only fetch meter readings made since this date |
|
Only fetch meter readings made until this date |
|
|
|
Query
query GasMeterReadings(
$accountNumber: String!,
$after: String,
$before: String,
$first: Int,
$last: Int,
$meterId: ID!,
$readFrom: DateTime,
$readTo: DateTime,
$readingOrigins: [ReadingOrigin],
$typesOfRead: [TypeOfRead]
) {
gasMeterReadings(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last,
meterId: $meterId,
readFrom: $readFrom,
readTo: $readTo,
readingOrigins: $readingOrigins,
typesOfRead: $typesOfRead
) {
edgeCount
edges {
...GasMeterReadingConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-33449712",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"meterId": "60464225",
"readFrom": "2015-02-21T13:44:06.486976+00:00",
"readTo": "1993-01-27T00:37:48.204908+00:00",
"readingOrigins": "CUSTOMER",
"typesOfRead": "METER_INSTALLED"
}
Response
{
"data": {
"gasMeterReadings": {
"edgeCount": 11,
"edges": GasMeterReadingConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 32
}
}
}
gasMeterReadingsByRegister
Type: GasMeterForReadingType
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch gas meter readings for a given account and meter, split up by register.
The possible errors that can be raised are:
- KT-CT-6421: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Query
query GasMeterReadingsByRegister(
$accountNumber: String!,
$meterId: ID!
) {
gasMeterReadingsByRegister(
accountNumber: $accountNumber,
meterId: $meterId
) {
registers {
...GasRegisterForReadingTypeFragment
}
}
}
Variables
{
"accountNumber": "A-5BF4D400",
"meterId": "15324428"
}
Response
{
"data": {
"gasMeterReadingsByRegister": {
"registers": [GasRegisterForReadingType]
}
}
}
gasMeters
Type: GasMeterConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch gas meters for a given account and MeLo.
This field is a connection type. Connections are used to implement cursor based pagination.
This field requires the Authorization header to be set.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Query
query GasMeters(
$accountNumber: String!,
$after: String,
$before: String,
$first: Int,
$last: Int,
$meloNumber: String!
) {
gasMeters(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last,
meloNumber: $meloNumber
) {
edgeCount
edges {
...GasMeterConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-91309BB4",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"meloNumber": "too-base-particularly-girl-amount"
}
Response
{
"data": {
"gasMeters": {
"edgeCount": 10,
"edges": GasMeterConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 6
}
}
}
gasSuppliers
Type: [SupplierType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns all the gas suppliers directly from the getAG API.
Query
query GasSuppliers {
gasSuppliers {
brandId
supplierId
supplierName
supplierNumber
}
}
Response
{
"data": {
"gasSuppliers": [
{
"brandId": 88475932,
"supplierId": 51165114,
"supplierName": "great-before-like-group-force",
"supplierNumber": "shoulder-thousand-great-moment-force"
}
]
}
}
getOnSiteJobsAppointmentByExternalReference
Type: OnSiteJobsAppointmentType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get appointment by external reference and agent.
Arguments
| Name | Description |
|---|---|
|
The agent for the appointment. |
|
The external reference of the appointment to return. |
Query
query GetOnSiteJobsAppointmentByExternalReference(
$agent: OnSiteJobsAgent!,
$externalReference: String!
) {
getOnSiteJobsAppointmentByExternalReference(
agent: $agent,
externalReference: $externalReference
) {
agent
appointmentActions {
...OnSiteJobsAppointmentActionConnectionTypeConnectionFragment
}
assets {
...OnSiteJobsAssetConnectionTypeConnectionFragment
}
cancellationCategory
cancellationSubCategory
comments
commsStrategy
createdAt
deadlineDate
endAt
externalJobType
externalReference
id
jobDetails
jobNotes
krakenWorkCategory
preferredStartDate
startAt
status
}
}
Variables
{
"agent": "GENERIC_AGENT",
"externalReference": "support-into-hair-develop-lose"
}
Response
{
"data": {
"getOnSiteJobsAppointmentByExternalReference": {
"agent": "GENERIC_AGENT",
"appointmentActions": OnSiteJobsAppointmentActionConnectionTypeConnection,
"assets": OnSiteJobsAssetConnectionTypeConnection,
"cancellationCategory": "CANCELLED_BY_CUSTOMER",
"cancellationSubCategory": "action-citizen-education-day-follow",
"comments": "easy-gun-part-message-hotel",
"commsStrategy": "SEND_ALL",
"createdAt": "1983-02-16T02:24:57.553881+00:00",
"deadlineDate": "1984-12-31",
"endAt": "1979-09-04T20:21:15.484341+00:00",
"externalJobType": "be-in-to-speech-board",
"externalReference": "ask-everybody-thought-itself-brother",
"id": "780f620e-226e-4204-bf60-f6eece45ef65",
"jobDetails": {"key": "value"},
"jobNotes": {"key": "value"},
"krakenWorkCategory": "EXCHANGE",
"preferredStartDate": "2015-03-13",
"startAt": "1972-12-21T02:59:03.265540+00:00",
"status": "PENDING"
}
}
}
getOnSiteJobsAppointmentById
Type: OnSiteJobsAppointmentType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a specific appointment by Kraken ID.
Arguments
| Name | Description |
|---|---|
|
The Kraken ID of the appointment to return. |
Query
query GetOnSiteJobsAppointmentById($appointmentId: UUID) {
getOnSiteJobsAppointmentById(appointmentId: $appointmentId) {
agent
appointmentActions {
...OnSiteJobsAppointmentActionConnectionTypeConnectionFragment
}
assets {
...OnSiteJobsAssetConnectionTypeConnectionFragment
}
cancellationCategory
cancellationSubCategory
comments
commsStrategy
createdAt
deadlineDate
endAt
externalJobType
externalReference
id
jobDetails
jobNotes
krakenWorkCategory
preferredStartDate
startAt
status
}
}
Variables
{
"appointmentId": "8178391d-7c33-495a-90cb-30684e71c9b4"
}
Response
{
"data": {
"getOnSiteJobsAppointmentById": {
"agent": "GENERIC_AGENT",
"appointmentActions": OnSiteJobsAppointmentActionConnectionTypeConnection,
"assets": OnSiteJobsAssetConnectionTypeConnection,
"cancellationCategory": "CANCELLED_BY_CUSTOMER",
"cancellationSubCategory": "production-letter-politics-hundred-peace",
"comments": "fight-generation-situation-pass-cost",
"commsStrategy": "SEND_ALL",
"createdAt": "2009-12-05T16:08:39.639361+00:00",
"deadlineDate": "1994-07-10",
"endAt": "1983-10-10T07:48:49.400160+00:00",
"externalJobType": "you-follow-young-test-receive",
"externalReference": "provide-growth-former-sell-meet",
"id": "1c6225f8-21cd-41eb-b195-4fc246089e50",
"jobDetails": {"key": "value"},
"jobNotes": {"key": "value"},
"krakenWorkCategory": "EXCHANGE",
"preferredStartDate": "2009-01-31",
"startAt": "2003-12-25T04:55:08.424698+00:00",
"status": "PENDING"
}
}
}
getOnSiteJobsAppointmentSlots
Type: OnSiteJobsAppointmentSlotResultsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get appointment slot results using appointment booking session ID.
Arguments
| Name | Description |
|---|---|
|
Appointment booking session ID to fetch slots for. ID can be obtained via |
|
Appointment date (inclusive) to fetch slots from. |
Query
query GetOnSiteJobsAppointmentSlots(
$appointmentBookingSessionId: UUID!,
$appointmentDate: Date!
) {
getOnSiteJobsAppointmentSlots(
appointmentBookingSessionId: $appointmentBookingSessionId,
appointmentDate: $appointmentDate
) {
isComplete
slots {
...OnSiteJobsAppointmentSlotTypeFragment
}
}
}
Variables
{
"appointmentBookingSessionId": "7171bc6b-bb00-4b28-b2ef-cde4359ef572",
"appointmentDate": "2020-08-27"
}
Response
{
"data": {
"getOnSiteJobsAppointmentSlots": {
"isComplete": true,
"slots": OnSiteJobsAppointmentSlotType
}
}
}
getOnSiteJobsCheckResults
Type: OnSiteJobsCheckResultsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get check results for creating requests and appointments.
Arguments
| Name | Description |
|---|---|
|
Job type for appointment checks. |
|
Supply point identifier to market name mapping. If this is provided, |
|
List of internal IDs of supply points. If this is provided, |
Query
query GetOnSiteJobsCheckResults(
$jobType: String,
$supplyPointIdentifierToMarketNameMapping: [SupplyPointIdentifierToMarketNameMappingInput],
$supplyPointInternalIds: [Int]
) {
getOnSiteJobsCheckResults(
jobType: $jobType,
supplyPointIdentifierToMarketNameMapping: $supplyPointIdentifierToMarketNameMapping,
supplyPointInternalIds: $supplyPointInternalIds
) {
appointmentCheckResults {
...CheckResultTypeFragment
}
canCreateAppointment
canCreateRequest
hasAppointmentWarnings
hasRequestWarnings
requestCheckResults {
...CheckResultTypeFragment
}
}
}
Variables
{
"jobType": "someone-miss-rather-rather-north",
"supplyPointIdentifierToMarketNameMapping": SupplyPointIdentifierToMarketNameMappingInput,
"supplyPointInternalIds": [26]
}
Response
{
"data": {
"getOnSiteJobsCheckResults": {
"appointmentCheckResults": [CheckResultType],
"canCreateAppointment": true,
"canCreateRequest": true,
"hasAppointmentWarnings": true,
"hasRequestWarnings": true,
"requestCheckResults": [CheckResultType]
}
}
}
getOnSiteJobsJobTypes
Type: [OnSiteJobsJobTypeType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get available job types for an on-site jobs request.
Arguments
| Name | Description |
|---|---|
|
The ID of the request for which to fetch available job types. |
|
Work category to filter job types by. If it's left as blank, all job types will be returned. |
Query
query GetOnSiteJobsJobTypes(
$requestId: UUID!,
$workCategory: OnSiteJobsWorkCategory
) {
getOnSiteJobsJobTypes(
requestId: $requestId,
workCategory: $workCategory
) {
id
name
}
}
Variables
{
"requestId": "35ca974e-eddf-4d24-9aef-d80b86e168f6",
"workCategory": "EXCHANGE"
}
Response
{
"data": {
"getOnSiteJobsJobTypes": [
{
"id": "14935884",
"name": "throw-discussion-back-though-put"
}
]
}
}
getOnSiteJobsRequestById
Type: OnSiteJobsRequestType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a specific request by ID.
Arguments
| Name | Description |
|---|---|
|
The ID of the request to return. |
Query
query GetOnSiteJobsRequestById($requestId: UUID) {
getOnSiteJobsRequestById(requestId: $requestId) {
account
agent
appointments {
...OnSiteJobsAppointmentConnectionTypeConnectionFragment
}
assets {
...OnSiteJobsAssetConnectionTypeConnectionFragment
}
comment
createdBy
externalReference
id
isEmergency
marketSupplyPoints {
...SupplyPointConnectionTypeConnectionFragment
}
overallActionsStatus
property {
...PropertyTypeFragment
}
reason
requestActions {
...OnSiteJobsRequestActionConnectionTypeConnectionFragment
}
status
subReason
}
}
Variables
{
"requestId": "f972f788-20d8-4ad7-b981-3d8be083583d"
}
Response
{
"data": {
"getOnSiteJobsRequestById": {
"account": "child-day-decision-specific-page",
"agent": "send-against-effect-guy-far",
"appointments": OnSiteJobsAppointmentConnectionTypeConnection,
"assets": OnSiteJobsAssetConnectionTypeConnection,
"comment": "unit-later-fear-view-suggest",
"createdBy": 15,
"externalReference": "enter-allow-benefit-property-return",
"id": "33c1aa1f-4399-4867-9c1e-4f65dde5629c",
"isEmergency": true,
"marketSupplyPoints": SupplyPointConnectionTypeConnection,
"overallActionsStatus": "PENDING",
"property": PropertyType,
"reason": "hour-few-else-try-important",
"requestActions": OnSiteJobsRequestActionConnectionTypeConnection,
"status": "BOOKED",
"subReason": "matter-college-nice-position-which"
}
}
}
getOnSiteJobsRequests
Type: OnSiteJobsRequestConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Filter On-Site Jobs Requests.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
A list of statuses to filter requests by. |
|
List of internal IDs of supply points to filter requests by. If this is provided, |
|
A list of supply point identifiers to filter requests by. If this is provided, |
Query
query GetOnSiteJobsRequests(
$after: String,
$before: String,
$first: Int,
$last: Int,
$statuses: [OnSiteJobsRequestStatus],
$supplyPointInternalIds: [Int],
$supplyPointsToMarketNamesMapping: [SupplyPointIdentifierToMarketNameMappingInput]
) {
getOnSiteJobsRequests(
after: $after,
before: $before,
first: $first,
last: $last,
statuses: $statuses,
supplyPointInternalIds: $supplyPointInternalIds,
supplyPointsToMarketNamesMapping: $supplyPointsToMarketNamesMapping
) {
edgeCount
edges {
...OnSiteJobsRequestConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"statuses": "BOOKED",
"supplyPointInternalIds": [21],
"supplyPointsToMarketNamesMapping": SupplyPointIdentifierToMarketNameMappingInput
}
Response
{
"data": {
"getOnSiteJobsRequests": {
"edgeCount": 68,
"edges": OnSiteJobsRequestConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 58
}
}
}
getQuoteByCode
Type: CreateQuoteOutput
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns the calculated quotes related to a quote request.
The possible errors that can be raised are:
- KT-CT-4619: Quote with given code not found.
- KT-CT-4627: No products are available for this quote.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The ID of the quote request. |
Query
query GetQuoteByCode($code: UUID!) {
getQuoteByCode(code: $code) {
affiliateSessionId
code
electricitySupplyPoint {
...QuotedSupplyPointTypeFragment
}
gasSupplyPoint {
...QuotedSupplyPointTypeFragment
}
requestedAt
}
}
Variables
{
"code": "a26741a7-3f90-4910-bcff-9afa3b9095d8"
}
Response
{
"data": {
"getQuoteByCode": {
"affiliateSessionId": "39218364",
"code": "4e580023-fe15-4bf4-b4e4-f8444f8fcd76",
"electricitySupplyPoint": QuotedSupplyPointType,
"gasSupplyPoint": QuotedSupplyPointType,
"requestedAt": "2016-09-22T18:34:00.828761+00:00"
}
}
}
getQuotedProductById
Type: QuotedProduct
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns a quoted product by id.
The possible errors that can be raised are:
- KT-DE-4601: No quoted product found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query GetQuotedProductById($id: Int) {
getQuotedProductById(id: $id) {
id
isValidForRetentionProductSwitch
monthlyStandingCharge
netMonthlyStandingCharge
product {
...ProductFragment
}
retentionNumberOfValidDays
retentionOfferGenerationDate
totalEstimatedAnnualBill
unitRateInformation {
... on SimpleProductUnitRateInformation {
...SimpleProductUnitRateInformationFragment
}
... on TimeOfUseProductUnitRateInformation {
...TimeOfUseProductUnitRateInformationFragment
}
}
wasSelected
}
}
Variables
{
"id": 53320167
}
Response
{
"data": {
"getQuotedProductById": {
"id": 50506474,
"isValidForRetentionProductSwitch": true,
"monthlyStandingCharge": "1.0",
"netMonthlyStandingCharge": "1.0",
"product": Product,
"retentionNumberOfValidDays": 76,
"retentionOfferGenerationDate": "1970-04-09",
"totalEstimatedAnnualBill": "1.0",
"unitRateInformation": SimpleProductUnitRateInformation,
"wasSelected": true
}
}
}
goodsProducts
Type: GoodsProductConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
List Goods products given a market.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
Code of the products to filter by. |
|
|
|
|
|
Market name of the products to list. |
|
Types of the products to filter by. |
Query
query GoodsProducts(
$after: String,
$before: String,
$code: [String],
$first: Int,
$last: Int,
$marketName: String!,
$productType: [String]
) {
goodsProducts(
after: $after,
before: $before,
code: $code,
first: $first,
last: $last,
marketName: $marketName,
productType: $productType
) {
edgeCount
edges {
...GoodsProductConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"code": ["card-agency-six-catch-lose"],
"first": 10,
"last": 10,
"marketName": "action-hour-will-traditional-machine",
"productType": ["option-rather-rule-give-store"]
}
Response
{
"data": {
"goodsProducts": {
"edgeCount": 48,
"edges": GoodsProductConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 92
}
}
}
goodsPurchases
Type: [GoodsPurchase]
URL: https://api.oeg-kraken.energy/v1/graphql/
List purchases for an account.
Arguments
| Name | Description |
|---|---|
|
The account number. |
Query
query GoodsPurchases($accountNumber: String!) {
goodsPurchases(accountNumber: $accountNumber) {
clientParams
code
goodsGrants {
...GoodsGrantFragment
}
goodsSaleItems {
...GoodsSaleItemFragment
}
ledgerNumber
marketName
marketParams
}
}
Variables
{
"accountNumber": "A-30DD5FDB"
}
Response
{
"data": {
"goodsPurchases": [
{
"clientParams": {"key": "value"},
"code": "avoid-detail-his-put-trial",
"goodsGrants": [GoodsGrant],
"goodsSaleItems": [GoodsSaleItem],
"ledgerNumber": "impact-fall-policy-garden-of",
"marketName": "edge-newspaper-summer-magazine-case",
"marketParams": {"key": "value"}
}
]
}
}
goodsQuotes
Type: [GoodsQuote]
URL: https://api.oeg-kraken.energy/v1/graphql/
List quotes given an account number or retrieve a Goods quote given a quote code.
The possible errors that can be raised are:
- KT-CT-8204: Invalid arguments.
- KT-CT-8223: Unauthorized.
- KT-CT-8201: Received an invalid quoteId.
- KT-CT-8204: Invalid arguments.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
The quote code. |
Query
query GoodsQuotes(
$accountNumber: String,
$quoteCode: String
) {
goodsQuotes(
accountNumber: $accountNumber,
quoteCode: $quoteCode
) {
code
goodsQuotedProducts {
...GoodsQuotedProductFragment
}
hasQuoteExpired
id
quotedAt
totalNetAmount
}
}
Variables
{
"accountNumber": "A-7C2997E9",
"quoteCode": "national-game-live-follow-heavy"
}
Response
{
"data": {
"goodsQuotes": [
{
"code": "page-understand-write-eight-ready",
"goodsQuotedProducts": [GoodsQuotedProduct],
"hasQuoteExpired": true,
"id": "77953582",
"quotedAt": "2011-10-10T10:47:14.874030+00:00",
"totalNetAmount": 83
}
]
}
}
inboundCallAverageWaitTime
Type: InboundCallAverageWaitTimeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the average wait time for an inbound call.
Query
query InboundCallAverageWaitTime {
inboundCallAverageWaitTime {
recent
yesterday
}
}
Response
{
"data": {
"inboundCallAverageWaitTime": {
"recent": 84,
"yesterday": 81
}
}
}
inkCommsTemplate
Type: String!
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch the content of a given comms template name.
The possible errors that can be raised are:
- KT-CT-7648: The comms template was not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The identifier of the comms template. |
Query
query InkCommsTemplate($templateIdentifier: String!) {
inkCommsTemplate(templateIdentifier: $templateIdentifier)
}
Variables
{
"templateIdentifier": "77232807"
}
Response
{
"data": {
"inkCommsTemplate": "design-six-enough-provide-make"
}
}
inkConversation
Type: InkConversation!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the Ink conversation for a given account.
The possible errors that can be raised are:
- KT-CT-7612: The Ink conversation was not found.
- KT-CT-4177: Unauthorized.
- KT-CT-7610: No Ink conversation for account.
- KT-CT-7617: Must supply account number or relay id to get a conversation.
- KT-CT-7638: Invalid conversation ID.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
The conversation's relay id. |
Query
query InkConversation(
$accountNumber: String,
$conversationRelayId: String
) {
inkConversation(
accountNumber: $accountNumber,
conversationRelayId: $conversationRelayId
) {
accountNumber
accountUsers {
...AccountUserTypeFragment
}
buckets {
...InkBucketFragment
}
contactChannelIdentities {
...InkContactChannelIdentitiesFragment
}
events {
...InkConversationEventsConnectionFragment
}
id
status
tags {
...InkTagFragment
}
}
}
Variables
{
"accountNumber": "A-2D11589B",
"conversationRelayId": "85764575"
}
Response
{
"data": {
"inkConversation": {
"accountNumber": "A-B9332255",
"accountUsers": [AccountUserType],
"buckets": [InkBucket],
"contactChannelIdentities": InkContactChannelIdentities,
"events": InkConversationEventsConnection,
"id": "20947385",
"status": "OPEN",
"tags": [InkTag]
}
}
}
inkMessage
Type: InkMessage!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the content for a given message.
The possible errors that can be raised are:
- KT-CT-7611: The message was not found.
- KT-CT-7638: Invalid conversation ID.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The message's relay id. |
Query
query InkMessage($messageRelayId: String!) {
inkMessage(messageRelayId: $messageRelayId) {
... on InkEmail {
...InkEmailFragment
}
... on InkGenericMessage {
...InkGenericMessageFragment
}
... on InkLine {
...InkLineFragment
}
... on InkLiveChatMessage {
...InkLiveChatMessageFragment
}
... on InkPost {
...InkPostFragment
}
... on InkSMS {
...InkSMSFragment
}
... on InkTwilioWhatsApp {
...InkTwilioWhatsAppFragment
}
... on InkWhatsApp {
...InkWhatsAppFragment
}
}
}
Variables
{
"messageRelayId": "65351033"
}
Response
{
"data": {
"inkMessage": InkEmail
}
}
inkMessageAttributes
Type: InkMessageAttributes!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get attributes of a message at time of query.
The possible errors that can be raised are:
- KT-CT-7611: The message was not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The message's vendor. |
|
The message's vendor id. |
Query
query InkMessageAttributes(
$vendor: String!,
$vendorId: String!
) {
inkMessageAttributes(
vendor: $vendor,
vendorId: $vendorId
) {
accountType
accounts
buckets
conversationId
hourOccurredAt
hoursWaiting
isAssignedToUserBucket
isFirstFromContact
isNewThread
opsTeam
recentlyReceivedAutoReplies
replyToCommsSms
weekDayOccurredAt
}
}
Variables
{
"vendor": "relationship-maintain-yard-society-several",
"vendorId": "10354419"
}
Response
{
"data": {
"inkMessageAttributes": {
"accountType": "dark-foot-shoulder-leg-strong",
"accounts": "amount-carry-enjoy-on-police",
"buckets": ["wind-begin-future-your-human"],
"conversationId": 80490680,
"hourOccurredAt": 76,
"hoursWaiting": 64,
"isAssignedToUserBucket": true,
"isFirstFromContact": true,
"isNewThread": true,
"opsTeam": "necessary-majority-run-fact-newspaper",
"recentlyReceivedAutoReplies": "same-production-tell-instead-manage",
"replyToCommsSms": "technology-newspaper-grow-everything-identify",
"weekDayOccurredAt": 39
}
}
}
inkMessageTextContent
Type: String!
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch the text content of a given message.
The possible errors that can be raised are:
- KT-CT-7611: The message was not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The message's id or relay id. |
Query
query InkMessageTextContent($messageId: ID!) {
inkMessageTextContent(messageId: $messageId)
}
Variables
{
"messageId": "78028043"
}
Response
{
"data": {
"inkMessageTextContent": "eat-cell-so-choice-open"
}
}
isCustomerEligibleToGiveFeedbackFollowingCall
Type: Boolean
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if customer is eligible to give feedback following a phone call.
The possible errors that can be raised are:
- KT-CT-5519: Voice call not found.
- KT-CT-5521: Eligibility configuration not found.
- KT-CT-5522: Invalid eligibility configuration.
- KT-CT-5523: Invalid account or account user.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Number of the account. |
|
Number of the account user. |
|
ID of the voice call. |
Query
query IsCustomerEligibleToGiveFeedbackFollowingCall(
$accountNumber: String!,
$accountUserNumber: String!,
$callId: Int!
) {
isCustomerEligibleToGiveFeedbackFollowingCall(
accountNumber: $accountNumber,
accountUserNumber: $accountUserNumber,
callId: $callId
)
}
Variables
{
"accountNumber": "A-D74CBD4A",
"accountUserNumber": "U-56A06E06",
"callId": 99207934
}
Response
{
"data": {
"isCustomerEligibleToGiveFeedbackFollowingCall": true
}
}
isCustomerEligibleToGiveFeedbackFollowingEmail
Type: Boolean
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if customer is eligible to give feedback following an email conversation.
The possible errors that can be raised are:
- KT-CT-5520: Ink conversation not found.
- KT-CT-5521: Eligibility configuration not found.
- KT-CT-5522: Invalid eligibility configuration.
- KT-CT-5523: Invalid account or account user.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Number of the account. |
|
Number of the account user. |
|
Datetime when the conversation was closed. |
|
ID of the Ink conversation. |
Query
query IsCustomerEligibleToGiveFeedbackFollowingEmail(
$accountNumber: String!,
$accountUserNumber: String!,
$conversationClosedAt: DateTime!,
$inkConversationId: Int!
) {
isCustomerEligibleToGiveFeedbackFollowingEmail(
accountNumber: $accountNumber,
accountUserNumber: $accountUserNumber,
conversationClosedAt: $conversationClosedAt,
inkConversationId: $inkConversationId
)
}
Variables
{
"accountNumber": "A-C8453C65",
"accountUserNumber": "U-31161CF5",
"conversationClosedAt": "1982-10-19T02:15:19.031994+00:00",
"inkConversationId": 80607901
}
Response
{
"data": {
"isCustomerEligibleToGiveFeedbackFollowingEmail": true
}
}
isCustomerKnownToKraken
Type: Boolean
URL: https://api.oeg-kraken.energy/v1/graphql/
Check whether a given customer is known to Kraken. The typical scenario to use this query in is to be able to tell whether an inbound cancellation market message concerns a Kraken account or not. Note: At the moment, this query only works for gas customers.
The possible errors that can be raised are:
- KT-DE-4501: Invalid postcode and city format.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The customer's full name. |
|
The meter number of the customer's gas meter. |
|
The customer's postcode and city. This is expected to be a string starting with a 5-digit postcode, followed by a space and then the city name. |
|
The customer's street and street number. |
Query
query IsCustomerKnownToKraken(
$customerName: String!,
$meterNumber: String!,
$postcodeAndCity: String!,
$streetAndNumber: String!
) {
isCustomerKnownToKraken(
customerName: $customerName,
meterNumber: $meterNumber,
postcodeAndCity: $postcodeAndCity,
streetAndNumber: $streetAndNumber
)
}
Variables
{
"customerName": "loss-them-size-challenge-drop",
"meterNumber": "claim-employee-dark-close-network",
"postcodeAndCity": "trial-take-perform-first-training",
"streetAndNumber": "decision-although-democratic-so-red"
}
Response
{
"data": {
"isCustomerKnownToKraken": true
}
}
isPasswordResetTokenValid
Type: Boolean
URL: https://api.oeg-kraken.energy/v1/graphql/
Check validity of a password reset token.
Arguments
| Name | Description |
|---|---|
|
Password reset token to check. |
|
Base64 encoded user id. |
Query
query IsPasswordResetTokenValid(
$token: String!,
$userId: String!
) {
isPasswordResetTokenValid(
token: $token,
userId: $userId
)
}
Variables
{
"token": "difficult-cut-no-affect-discussion",
"userId": "29001542"
}
Response
{
"data": {
"isPasswordResetTokenValid": true
}
}
joinSupplierProcess
Type: JoinSupplierProcessType
URL: https://api.oeg-kraken.energy/v1/graphql/
The possible errors that can be raised are:
- KT-CT-10332: Join supplier process not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The join supplier process number, e.g. JS-12345678. |
Query
query JoinSupplierProcess($number: String!) {
joinSupplierProcess(number: $number) {
currentProcessData {
...JoinSupplierProcessDataTypeFragment
}
id
ledgerAssignments {
...JoinSupplierLedgerAssignmentConnectionTypeConnectionFragment
}
number
status
subtype
supplyPoints {
...SupplyPointConnectionTypeConnectionFragment
}
}
}
Variables
{
"number": "police-establish-not-off-per"
}
Response
{
"data": {
"joinSupplierProcess": {
"currentProcessData": JoinSupplierProcessDataType,
"id": "30808305",
"ledgerAssignments": JoinSupplierLedgerAssignmentConnectionTypeConnection,
"number": "wide-benefit-three-rise-some",
"status": "PENDING",
"subtype": "whole-enough-mission-hard-require",
"supplyPoints": SupplyPointConnectionTypeConnection
}
}
}
krakenVersion
Type: KrakenVersionType
URL: https://api.oeg-kraken.energy/v1/graphql/
The current version of kraken.
Query
query KrakenVersion {
krakenVersion {
SHA
isPinned
number
}
}
Response
{
"data": {
"krakenVersion": {
"SHA": "later-difficult-decide-idea-tax",
"isPinned": true,
"number": "people-church-feel-far-star"
}
}
}
leadBlocklistValidations
Type: LeadBlockListValidationOutput
URL: https://api.oeg-kraken.energy/v1/graphql/
Run a blocklist validation out of some dynamic client entry types.
Arguments
| Name | Description |
|---|---|
|
List of client-configured black list entry types. |
Query
query LeadBlocklistValidations($blockListEntries: LeadBlockListValidationInput) {
leadBlocklistValidations(blockListEntries: $blockListEntries) {
blockListHits
valid
}
}
Variables
{
"blockListEntries": LeadBlockListValidationInput
}
Response
{
"data": {
"leadBlocklistValidations": {
"blockListHits": ["capital-simple-arm-interest-item"],
"valid": true
}
}
}
leadByNumber
Type: LeadOutput
URL: https://api.oeg-kraken.energy/v1/graphql/
Get lead details by number.
The possible errors that can be raised are:
- KT-CT-8907: Lead not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Lead number. |
Query
query LeadByNumber($number: String) {
leadByNumber(number: $number) {
accountNumber
assignedToAffiliateNumber
assignedToTeam
assignedToUser
billingAddress {
...AddressOutputFragment
}
billingName
billingRichAddress {
...RichAddressTypeFragment
}
brand
consents {
...ConsentOutputFragment
}
email
extraDetailItems {
...ExtraDetailFragment
}
familyName
funnel {
...SalesFunnelFragment
}
givenName
leadId
leadType
nationalId
number
phoneNumber
salesChannel
stage
}
}
Variables
{
"number": "event-girl-effect-hundred-nearly"
}
Response
{
"data": {
"leadByNumber": {
"accountNumber": "A-95D99B2C",
"assignedToAffiliateNumber": "involve-raise-ten-raise-soldier",
"assignedToTeam": "offer-ok-north-approach-purpose",
"assignedToUser": "after-reach-matter-military-address",
"billingAddress": AddressOutput,
"billingName": "blue-international-summer-professional-herself",
"billingRichAddress": RichAddressType,
"brand": "represent-very-order-community-thus",
"consents": [ConsentOutput],
"email": "pass-significant-institution-down-arrive",
"extraDetailItems": [ExtraDetail],
"familyName": "James",
"funnel": SalesFunnel,
"givenName": "Edwin",
"leadId": "24774168",
"leadType": "much-TV-read-movement-consider",
"nationalId": "85877305",
"number": "character-job-operation-expect-agreement",
"phoneNumber": "four-term-above-century-animal",
"salesChannel": "image-answer-a-building-strategy",
"stage": "marriage-six-toward-however-bring"
}
}
}
leads
Type: LeadsConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch all leads for this Kraken, with optional filtering.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
Input fields for retrieving leads. |
|
Query
query Leads(
$after: String,
$before: String,
$first: Int,
$input: LeadsQueryInput,
$last: Int
) {
leads(
after: $after,
before: $before,
first: $first,
input: $input,
last: $last
) {
edgeCount
edges {
...LeadsEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"input": LeadsQueryInput,
"last": 10
}
leaveSupplierProcess
Type: LeaveSupplierProcessType
URL: https://api.oeg-kraken.energy/v1/graphql/
Details associated with a LeaveSupplier process.
The possible errors that can be raised are:
- KT-CT-10302: Invalid data.
- KT-CT-10333: Missing either number of leave supplier process id.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The leave supplier process number, e.g. LS-12345678. |
Query
query LeaveSupplierProcess($number: String) {
leaveSupplierProcess(number: $number) {
id
number
status
subtype
supplyPoints {
...SupplyPointConnectionTypeConnectionFragment
}
}
}
Variables
{
"number": "fear-six-audience-sing-color"
}
Response
{
"data": {
"leaveSupplierProcess": {
"id": "84956306",
"number": "me-fine-concern-carry-describe",
"status": "PENDING",
"subtype": "security-close-whether-small-billion",
"supplyPoints": SupplyPointConnectionTypeConnection
}
}
}
lifecycleProcesses
Type: LifecycleProcessesType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all lifecycle processes associated with an account.
The possible errors that can be raised are:
- KT-CT-4123: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number, e.g. A-12345678. |
|
A flag to filter out only active/current processes. |
|
The chronological order in which the lifecycle processes are sorted. |
Query
query LifecycleProcesses(
$accountNumber: String!,
$onlyActive: Boolean,
$sortOrder: LifecycleProcessesSortOrder
) {
lifecycleProcesses(
accountNumber: $accountNumber,
onlyActive: $onlyActive,
sortOrder: $sortOrder
) {
joinSupplierProcesses {
...JoinSupplierProcessConnectionTypeConnectionFragment
}
leavePropertyProcesses {
...LeavePropertyProcessConnectionTypeConnectionFragment
}
leaveSupplierProcesses {
...LeaveSupplierProcessConnectionTypeConnectionFragment
}
occupyPropertyProcesses {
...OccupyPropertyProcessConnectionTypeConnectionFragment
}
}
}
Variables
{
"accountNumber": "A-1A3C41D0",
"onlyActive": true,
"sortOrder": "ASC"
}
Response
{
"data": {
"lifecycleProcesses": {
"joinSupplierProcesses": JoinSupplierProcessConnectionTypeConnection,
"leavePropertyProcesses": LeavePropertyProcessConnectionTypeConnection,
"leaveSupplierProcesses": LeaveSupplierProcessConnectionTypeConnection,
"occupyPropertyProcesses": OccupyPropertyProcessConnectionTypeConnection
}
}
}
livePaymentAdequacyCalculation
Type: LivePaymentAdequacyCalculation
URL: https://api.oeg-kraken.energy/v1/graphql/
Get payment adequacy data with an up to date calculation.
The possible errors that can be raised are:
- KT-CT-3963: Could not calculate live PA data.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Kraken ledger number. |
Query
query LivePaymentAdequacyCalculation($ledgerNumber: String!) {
livePaymentAdequacyCalculation(ledgerNumber: $ledgerNumber) {
averageMonthlyCharge
balanceAdjustment
consumption {
...ConsumptionBreakdownConnectionTypeConnectionFragment
}
currentBalance
existingMonthlyAmount
reviewedOn
suggestedNewMonthlyAmount
targetBalance
}
}
Variables
{
"ledgerNumber": "single-meeting-very-agree-most"
}
Response
{
"data": {
"livePaymentAdequacyCalculation": {
"averageMonthlyCharge": 3,
"balanceAdjustment": 68,
"consumption": ConsumptionBreakdownConnectionTypeConnection,
"currentBalance": 22,
"existingMonthlyAmount": 70,
"reviewedOn": "2020-02-14",
"suggestedNewMonthlyAmount": 66,
"targetBalance": 30
}
}
}
loyaltyCards
Type: [LoyaltyCardType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all loyalty cards for the given account user.
The possible errors that can be raised are:
- KT-CT-5412: No account user exists with the given id.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Account user id. |
Query
query LoyaltyCards($accountUserId: String!) {
loyaltyCards(accountUserId: $accountUserId) {
id
number
scheme
status
}
}
Variables
{
"accountUserId": "38859656"
}
Response
{
"data": {
"loyaltyCards": [
{
"id": "52132844",
"number": "purpose-large-particular-religious-he",
"scheme": "travel-front-beat-draw-run",
"status": "work-personal-decade-character-stuff"
}
]
}
}
loyaltyPointLedgerEntry
Type: LoyaltyPointLedgerEntryType
URL: https://api.oeg-kraken.energy/v1/graphql/
Resolve a loyalty point ledger entry.
The possible errors that can be raised are:
- KT-CT-9215: Loyalty points balance query disabled.
- KT-CT-9223: Loyalty points ledger entry not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query LoyaltyPointLedgerEntry($input: LoyaltyPointLedgerEntryInput!) {
loyaltyPointLedgerEntry(input: $input) {
accountNumber
balanceBroughtForward
balanceCarriedForward
id
idempotencyKey
ledgerType
postedAt
reasonCode
value
}
}
Variables
{
"input": LoyaltyPointLedgerEntryInput
}
Response
{
"data": {
"loyaltyPointLedgerEntry": {
"accountNumber": "A-AD919678",
"balanceBroughtForward": "game-mother-amount-bit-federal",
"balanceCarriedForward": "for-onto-truth-drive-this",
"id": "15796007",
"idempotencyKey": "522e156f-29a0-41b2-9af5-4a5d321393a5",
"ledgerType": "home-receive-evidence-although-really",
"postedAt": "2025-04-23T21:55:31.659625+00:00",
"reasonCode": "require-fly-likely-certainly-base",
"value": "yourself-street-senior-feel-true"
}
}
}
loyaltyPointLedgers
Type: [LoyaltyPointLedgerEntryType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the Loyalty Point ledger entries for the passed user.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The input object for retrieving a loyalty point ledger entry. |
Query
query LoyaltyPointLedgers($input: LoyaltyPointLedgersInput) {
loyaltyPointLedgers(input: $input) {
accountNumber
balanceBroughtForward
balanceCarriedForward
id
idempotencyKey
ledgerType
postedAt
reasonCode
value
}
}
Variables
{
"input": LoyaltyPointLedgersInput
}
Response
{
"data": {
"loyaltyPointLedgers": [
{
"accountNumber": "A-9D3F1938",
"balanceBroughtForward": "player-dark-president-wait-suddenly",
"balanceCarriedForward": "yeah-type-similar-management-build",
"id": "57009272",
"idempotencyKey": "79ecc485-11bb-4fca-8c6e-0e7334d5d22d",
"ledgerType": "against-particularly-method-need-far",
"postedAt": "1970-05-15T05:12:58.536688+00:00",
"reasonCode": "individual-carry-four-member-participant",
"value": "good-society-dog-something-recognize"
}
]
}
}
loyaltyPointsBalance
Type: AccountLoyaltyPointsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the loyalty points balance for an account.
The possible errors that can be raised are:
- KT-CT-9218: Unauthorized.
- KT-CT-9217: Unauthorized.
- KT-CT-9215: Loyalty points balance query disabled.
- KT-CT-9216: Unauthorized.
- KT-CT-9222: Loyalty points balance query requires either accountNumber field (deprecated) or input object (preferred) with account number and optional account user id.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query LoyaltyPointsBalance($input: LoyaltyPointsBalanceInput) {
loyaltyPointsBalance(input: $input) {
loyaltyPoints
totalMonetaryAmount
}
}
Variables
{
"input": LoyaltyPointsBalanceInput
}
Response
{
"data": {
"loyaltyPointsBalance": {
"loyaltyPoints": 84,
"totalMonetaryAmount": 32
}
}
}
metadata
Type: [Metadata]
URL: https://api.oeg-kraken.energy/v1/graphql/
Metadata for a linked object.
The possible errors that can be raised are:
- KT-CT-4123: Unauthorized.
- KT-CT-4124: Unauthorized.
- KT-CT-8411: Invalid data.
- KT-CT-4177: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
|
|
Query
query Metadata(
$identifier: String!,
$linkedObjectType: LinkedObjectType
) {
metadata(
identifier: $identifier,
linkedObjectType: $linkedObjectType
) {
key
value
}
}
Variables
{
"identifier": "94255218",
"linkedObjectType": "ACCOUNT"
}
Response
{
"data": {
"metadata": [
{
"key": "door-spring-bring-state-technology",
"value": {"key": "value"}
}
]
}
}
metadataForKey
Type: Metadata
URL: https://api.oeg-kraken.energy/v1/graphql/
Metadata for a linked object with key.
The possible errors that can be raised are:
- KT-CT-4123: Unauthorized.
- KT-CT-4124: Unauthorized.
- KT-CT-8411: Invalid data.
- KT-CT-4179: No metadata found with given key.
- KT-CT-4155: Invalid data.
- KT-CT-4177: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
Query
query MetadataForKey(
$identifier: String!,
$key: String!,
$linkedObjectType: LinkedObjectType
) {
metadataForKey(
identifier: $identifier,
key: $key,
linkedObjectType: $linkedObjectType
) {
key
value
}
}
Variables
{
"identifier": "79659738",
"key": "among-year-similar-clear-sea",
"linkedObjectType": "ACCOUNT"
}
Response
{
"data": {
"metadataForKey": {
"key": "many-order-however-always-end",
"value": {"key": "value"}
}
}
}
mfaDevices
Type: [MfaDevice]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all MFA devices for the current user.
Query
query MfaDevices {
mfaDevices {
deviceType
isConfirmed
}
}
Response
{
"data": {
"mfaDevices": [
{
"deviceType": "shake-shoulder-beat-son-baby",
"isConfirmed": true
}
]
}
}
node
Type: Node
URL: https://api.oeg-kraken.energy/v1/graphql/
Represents an individual object/resource in the API.
Arguments
| Name | Description |
|---|---|
|
The ID of the object |
Query
query Node($id: ID!) {
node(id: $id) {
id
}
}
Variables
{
"id": "72880731"
}
Response
{
"data": {
"node": {
"id": "33203501"
}
}
}
ocppConnection
Type: OCPPConnectionType
URL: https://api.oeg-kraken.energy/v1/graphql/
To confirm whether a device is connected to OCPP.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-4311: Unable to confirm OCPP connection.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query OcppConnection($accountNumber: String!) {
ocppConnection(accountNumber: $accountNumber) {
isConnected
}
}
Variables
{
"accountNumber": "A-6D4001DF"
}
Response
{
"data": {
"ocppConnection": {
"isConnected": true
}
}
}
ocppDetails
Type: OCPPDetailsType
URL: https://api.oeg-kraken.energy/v1/graphql/
The user specific generated OCPP details.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query OcppDetails($accountNumber: String!) {
ocppDetails(accountNumber: $accountNumber) {
url
username
}
}
Variables
{
"accountNumber": "A-B15251B1"
}
Response
{
"data": {
"ocppDetails": {
"url": "old-nature-indicate-price-its",
"username": "also-star-fire-TV-race"
}
}
}
Arguments
| Name | Description |
|---|---|
|
The identifier of the offer to query. |
Query
query OfferForQuoting($identifier: ID) {
offerForQuoting(identifier: $identifier) {
acceptedAt
createdBy {
...ActorTypeFragment
}
description
identifier
quote {
...QuoteType_Fragment
}
rejectedAt
validFrom
validTo
}
}
Variables
{
"identifier": "50492347"
}
Response
{
"data": {
"offerForQuoting": {
"acceptedAt": "2004-01-31T17:22:14.056816+00:00",
"createdBy": ActorType,
"description": "drive-himself-recently-author-night",
"identifier": "85322124",
"quote": QuoteType_,
"rejectedAt": "1980-04-26T16:28:37.590627+00:00",
"validFrom": "1982-11-10T08:36:48.679791+00:00",
"validTo": "1975-09-27T18:39:38.384086+00:00"
}
}
}
Arguments
| Name | Description |
|---|---|
|
The identifier of the offer group to query. |
Query
query OfferGroupForQuoting($identifier: ID) {
offerGroupForQuoting(identifier: $identifier) {
createdAt
createdBy {
...ActorTypeFragment
}
identifier
offers {
...OfferTypeFragment
}
}
}
Variables
{
"identifier": "45943392"
}
offering
Type: OfferingType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about a product offering.
The possible errors that can be raised are:
- KT-CT-12001: Product catalogue offering with given identifier not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The identifier of the offering to query. |
Query
query Offering($identifier: String) {
offering(identifier: $identifier) {
customerDescription
customerName
groups {
...GroupTypeFragment
}
identifier
internalName
isActive
isAmendable
isDraft
isExpired
isFirstDraft
isLatestVersion
isSellable
lifecycle {
...LifecycleTypeFragment
}
offeringComponents {
...OfferingComponentTypeFragment
}
productComponents {
...ProductComponentTypeFragment
}
tags {
...TagTypeFragment
}
termTemplateComponents {
...TermTemplateComponentTypeFragment
}
}
}
Variables
{
"identifier": "52404816"
}
Response
{
"data": {
"offering": {
"customerDescription": "mind-back-happen-along-least",
"customerName": "federal-others-Congress-need-meeting",
"groups": [GroupType],
"identifier": "95224462",
"internalName": "sound-exist-apply-current-let",
"isActive": true,
"isAmendable": true,
"isDraft": true,
"isExpired": true,
"isFirstDraft": true,
"isLatestVersion": true,
"isSellable": true,
"lifecycle": LifecycleType,
"offeringComponents": [OfferingComponentType],
"productComponents": [ProductComponentType],
"tags": [TagType],
"termTemplateComponents": [TermTemplateComponentType]
}
}
}
opportunities
Type: OpportunitiesConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Fetch all opportunities for this Kraken, with optional filtering.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
Input fields for retrieving opportunities. |
|
Query
query Opportunities(
$after: String,
$before: String,
$first: Int,
$input: OpportunitiesQueryInput,
$last: Int
) {
opportunities(
after: $after,
before: $before,
first: $first,
input: $input,
last: $last
) {
edgeCount
edges {
...OpportunitiesEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"input": OpportunitiesQueryInput,
"last": 10
}
Response
{
"data": {
"opportunities": {
"edgeCount": 2,
"edges": OpportunitiesEdge,
"pageInfo": PageInfo,
"totalCount": 90
}
}
}
opportunityByNumber
Type: OpportunityOutput
URL: https://api.oeg-kraken.energy/v1/graphql/
Get opportunity details by number.
The possible errors that can be raised are:
- KT-CT-8906: Opportunity not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Opportunity number identifier. |
Query
query OpportunityByNumber($number: String) {
opportunityByNumber(number: $number) {
assignedToAffiliateNumber
assignedToTeam
assignedToUser
attachments {
...OpportunityAttachmentFragment
}
consents {
...ConsentOutputFragment
}
email
extraDetailItems {
...ExtraDetailFragment
}
funnel {
...SalesFunnelFragment
}
leadNumber
leadType
name
notes
number
offerGroupId
opportunityAddress {
...AddressOutputFragment
}
opportunityRichAddress {
...RichAddressTypeFragment
}
phoneNumber
productOffering {
...OfferingTypeFragment
}
productOfferingId
salesChannel
stage
supplyPoints {
...LeadSupplyPointTypeFragment
}
}
}
Variables
{
"number": "avoid-the-main-traditional-need"
}
Response
{
"data": {
"opportunityByNumber": {
"assignedToAffiliateNumber": "live-minute-high-become-relationship",
"assignedToTeam": "program-player-official-minute-what",
"assignedToUser": "teacher-natural-film-civil-concern",
"attachments": [OpportunityAttachment],
"consents": [ConsentOutput],
"email": "subject-computer-themselves-film-everybody",
"extraDetailItems": [ExtraDetail],
"funnel": SalesFunnel,
"leadNumber": "rise-high-surface-another-shake",
"leadType": "score-partner-thing-military-two",
"name": "bank-whose-tax-account-significant",
"notes": "agreement-listen-expect-white-debate",
"number": "star-require-friend-even-such",
"offerGroupId": "83408666",
"opportunityAddress": AddressOutput,
"opportunityRichAddress": RichAddressType,
"phoneNumber": "buy-three-down-Congress-care",
"productOffering": OfferingType,
"productOfferingId": "27182940",
"salesChannel": "source-east-score-rest-surface",
"stage": "whole-very-hour-describe-about",
"supplyPoints": [LeadSupplyPointType]
}
}
}
opportunityProductSummary
Type: [OpportunityProductSummary!]!
URL: https://api.oeg-kraken.energy/v1/graphql/
Return summaries of all products in opportunity's accepted offer. Supports multi-product offerings like dual fuel.
The possible errors that can be raised are:
- KT-CT-8906: Opportunity not found.
- KT-CT-8923: The opportunity does not have a linked offer group.
- KT-CT-8922: The opportunity does not have an accepted offer.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Opportunity number. |
Query
query OpportunityProductSummary($number: String) {
opportunityProductSummary(number: $number) {
market
productCharacteristics
productCode
productIdentifier
productOfferingIdentifier
}
}
Variables
{
"number": "result-less-word-alone-son"
}
Response
{
"data": {
"opportunityProductSummary": [
{
"market": "save-figure-store-my-least",
"productCharacteristics": "abc123" | 1 | 1.0 | true | ["abc123"] | AccountType,
"productCode": "risk-forget-crime-six-executive",
"productIdentifier": "71693407",
"productOfferingIdentifier": "93983314"
}
]
}
}
opportunityValueByKey
Type: String
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the value of a given key that is stored in an opportunity's related JSONFields.
The possible errors that can be raised are:
- KT-CT-8903: Unable to update opportunity.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The key the a funnel-specific value you wish to obtain. |
|
The identifier of the opportunity to query. |
Query
query OpportunityValueByKey(
$key: String,
$opportunityId: ID
) {
opportunityValueByKey(
key: $key,
opportunityId: $opportunityId
)
}
Variables
{
"key": "great-design-huge-five-accept",
"opportunityId": "94545510"
}
Response
{
"data": {
"opportunityValueByKey": "ahead-design-perhaps-break-notice"
}
}
orderDetails
Type: OrderDetailsType
URL: https://api.oeg-kraken.energy/v1/graphql/
The possible errors that can be raised are:
- KT-CT-13101: Order not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Order identifier. |
Query
query OrderDetails($identifier: String!) {
orderDetails(identifier: $identifier) {
order {
...OrderTypeFragment
}
resources {
...OrderResourceFragment
}
status
}
}
Variables
{
"identifier": "48044412"
}
Response
{
"data": {
"orderDetails": {
"order": OrderType,
"resources": [OrderResource],
"status": "PENDING"
}
}
}
passwordValidatorHelpTexts
Type: [String]
URL: https://api.oeg-kraken.energy/v1/graphql/
The help text of all configured password validators as plain-text or html. Defaults to plain-text.
Arguments
| Name | Description |
|---|---|
|
Return the results as html instead of plain-text. Defaults to False. |
Query
query PasswordValidatorHelpTexts($asHtml: Boolean) {
passwordValidatorHelpTexts(asHtml: $asHtml)
}
Variables
{
"asHtml": true
}
Response
{
"data": {
"passwordValidatorHelpTexts": ["still-outside-at-represent-wife"]
}
}
paymentFingerprintChecks
Type: PaymentFingerPrintCheckType
URL: https://api.oeg-kraken.energy/v1/graphql/
Check if a given payment fingerprint already exists and/or is risk-listed.
Arguments
| Name | Description |
|---|---|
|
Fingerprint. |
Query
query PaymentFingerprintChecks($fingerprint: String!) {
paymentFingerprintChecks(fingerprint: $fingerprint) {
fingerprint
isFound
isRiskListed
}
}
Variables
{
"fingerprint": "idea-camera-save-Republican-environment"
}
Response
{
"data": {
"paymentFingerprintChecks": {
"fingerprint": "view-reason-operation-occur-technology",
"isFound": true,
"isRiskListed": true
}
}
}
paymentInstructionByLedger
Type: PaymentInstructionType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the payment instruction for the account's supplementary ledger.
The possible errors that can be raised are:
- KT-CT-3923: Unauthorized.
- KT-DE-3910: Invalid data.
- KT-DE-3911: Invalid/No payment instruction found for the given account.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
Supply type filter (ELECTRICITY or GAS). |
Query
query PaymentInstructionByLedger(
$accountNumber: String!,
$supplyType: String!
) {
paymentInstructionByLedger(
accountNumber: $accountNumber,
supplyType: $supplyType
) {
accountHolder
accountType
bankCode
cardExpiryMonth
cardExpiryYear
cardNumber
cardPaymentNetwork
cardType
iban
id
instructionType
maskedAccountIdentifier
owners {
...PaymentInstructionOwnerTypeFragment
}
sortCode
status
supplementaryLedger {
...SupplementaryLedgerTypeFragment
}
validFrom
vendor
}
}
Variables
{
"accountNumber": "A-76E8C1AB",
"supplyType": "financial-detail-PM-memory-some"
}
Response
{
"data": {
"paymentInstructionByLedger": {
"accountHolder": "knowledge-base-audience-discuss-model",
"accountType": "resource-new-act-well-leader",
"bankCode": "music-court-during-degree-paper",
"cardExpiryMonth": 40,
"cardExpiryYear": 34,
"cardNumber": "turn-enter-answer-themselves-phone",
"cardPaymentNetwork": "talk-kid-deal-firm-product",
"cardType": "boy-pull-book-air-player",
"iban": "career-other-this-wind-key",
"id": "13860663",
"instructionType": "nice-store-common-mother-trouble",
"maskedAccountIdentifier": "40060821",
"owners": [PaymentInstructionOwnerType],
"sortCode": "catch-administration-case-trial-be",
"status": "much-crime-account-evidence-else",
"supplementaryLedger": SupplementaryLedgerType,
"validFrom": "2000-07-03T13:44:26.991729+00:00",
"vendor": "them-morning-mouth-everything-conference"
}
}
}
paymentRequests
Type: PaymentRequestsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all payment requests for the given ledger.
Arguments
| Name | Description |
|---|---|
|
Kraken ledger number. |
Query
query PaymentRequests($ledgerNumber: String!) {
paymentRequests(ledgerNumber: $ledgerNumber) {
paymentRequest {
...PaymentRequestConnectionTypeConnectionFragment
}
}
}
Variables
{
"ledgerNumber": "anything-other-we-brother-program"
}
Response
{
"data": {
"paymentRequests": {
"paymentRequest": PaymentRequestConnectionTypeConnection
}
}
}
personalWinterWorkout
Type: WinterWorkoutType
URL: https://api.oeg-kraken.energy/v1/graphql/
Statistics about an account's weekly and total gas savings during the Winter Workout.
The possible errors that can be raised are:
- KT-CT-3823: Unauthorized.
- KT-CT-3956: Temporary error occurred.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number for which to get the Winter Workout data. |
Query
query PersonalWinterWorkout($accountNumber: String!) {
personalWinterWorkout(accountNumber: $accountNumber) {
total {
...WinterWorkoutPeriodTypeFragment
}
weeks {
...WinterWorkoutPeriodTypeFragment
}
}
}
Variables
{
"accountNumber": "A-4BD6BB17"
}
Response
{
"data": {
"personalWinterWorkout": {
"total": WinterWorkoutPeriodType,
"weeks": WinterWorkoutPeriodType
}
}
}
plannedDispatches
Type: [UpsideDispatchType]
URL: https://api.oeg-kraken.energy/v1/graphql/
All planned device dispatches 24 hours ahead, (usually) in time order.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-4340: Unable to fetch planned dispatches.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'plannedDispatches' field is deprecated.
Please use 'flexPlannedDispatches' instead.
- Marked as deprecated on 2025-05-27.
- Scheduled for removal on or after 2026-01-16.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/604/
Arguments
| Name | Description |
|---|---|
|
Query
query PlannedDispatches($accountNumber: String!) {
plannedDispatches(accountNumber: $accountNumber) {
delta
end
meta {
...UpsideDispatchMetaTypeFragment
}
start
}
}
Variables
{
"accountNumber": "A-FFE8043D"
}
Response
{
"data": {
"plannedDispatches": [
{
"delta": "1.0",
"end": "2014-07-04T14:50:27.654725+00:00",
"meta": UpsideDispatchMetaType,
"start": "2011-09-10T20:43:41.930645+00:00"
}
]
}
}
portfolio
Type: PortfolioType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about a portfolio, using its portfolio number.
The possible errors that can be raised are:
- KT-CT-9403: Received an invalid portfolioId.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Portfolio number to be retrieved. |
Query
query Portfolio($portfolioNumber: String!) {
portfolio(portfolioNumber: $portfolioNumber) {
accounts {
...AccountConnectionTypeConnectionFragment
}
ancestors {
...PortfolioConnectionTypeConnectionFragment
}
billingName
brand
collectiveBilling
createdAt
depth
descendants {
...PortfolioConnectionTypeConnectionFragment
}
id
leadAccountNumber
name
number
operationsTeam {
...OperationsTeamTypeFragment
}
parent {
...PortfolioTypeFragment
}
updatedAt
}
}
Variables
{
"portfolioNumber": "P-CE88F676"
}
Response
{
"data": {
"portfolio": {
"accounts": AccountConnectionTypeConnection,
"ancestors": PortfolioConnectionTypeConnection,
"billingName": "plan-represent-relate-these-who",
"brand": "worry-throughout-know-themselves-music",
"collectiveBilling": true,
"createdAt": "1986-06-21T07:48:28.624244+00:00",
"depth": 59,
"descendants": PortfolioConnectionTypeConnection,
"id": "20932440",
"leadAccountNumber": "A-86E3D330",
"name": "appear-most-morning-weight-set",
"number": "kitchen-shoulder-its-manage-allow",
"operationsTeam": OperationsTeamType,
"parent": PortfolioType,
"updatedAt": "1976-02-15T08:24:46.341731+00:00"
}
}
}
portfolioByReference
Type: PortfolioType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get details about a portfolio, using its reference.
The possible errors that can be raised are:
- KT-CT-9409: Invalid portfolio reference.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Portfolio reference namespace-value pair to filter by. |
Query
query PortfolioByReference($portfolioReference: PortfolioReferenceInput!) {
portfolioByReference(portfolioReference: $portfolioReference) {
accounts {
...AccountConnectionTypeConnectionFragment
}
ancestors {
...PortfolioConnectionTypeConnectionFragment
}
billingName
brand
collectiveBilling
createdAt
depth
descendants {
...PortfolioConnectionTypeConnectionFragment
}
id
leadAccountNumber
name
number
operationsTeam {
...OperationsTeamTypeFragment
}
parent {
...PortfolioTypeFragment
}
updatedAt
}
}
Variables
{
"portfolioReference": PortfolioReferenceInput
}
Response
{
"data": {
"portfolioByReference": {
"accounts": AccountConnectionTypeConnection,
"ancestors": PortfolioConnectionTypeConnection,
"billingName": "wrong-owner-morning-east-effect",
"brand": "see-risk-project-draw-wife",
"collectiveBilling": true,
"createdAt": "1983-09-21T12:01:41.898651+00:00",
"depth": 31,
"descendants": PortfolioConnectionTypeConnection,
"id": "70842140",
"leadAccountNumber": "A-F3DACFB9",
"name": "music-why-they-attorney-officer",
"number": "must-agent-hot-great-thousand",
"operationsTeam": OperationsTeamType,
"parent": PortfolioType,
"updatedAt": "2020-09-07T00:06:06.839285+00:00"
}
}
}
possibleErrors
Type: PossibleErrorsOutputType
URL: https://api.oeg-kraken.energy/v1/graphql/
Possible errors of the requested query/mutation.
The possible errors that can be raised are:
- KT-CT-1606: Query/Mutation not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query or Mutation for which to get the possible errors list. |
Query
query PossibleErrors($input: PossibleErrorsInputType!) {
possibleErrors(input: $input) {
authErrors
name
possibleErrors {
...PossibleErrorTypeFragment
}
type
}
}
Variables
{
"input": PossibleErrorsInputType
}
Response
{
"data": {
"possibleErrors": {
"authErrors": true,
"name": "quality-think-good-speech-early",
"possibleErrors": [PossibleErrorType],
"type": "query"
}
}
}
printBatch
Type: PrintBatchType!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get print batch details, including messages in the batch.
The possible errors that can be raised are:
- KT-CT-9013: Invalid data.
- KT-CT-9012: Invalid data.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The print batch ID. |
Query
query PrintBatch($batchId: ID) {
printBatch(batchId: $batchId) {
id
messages {
...PrintMessageTypeConnectionFragment
}
status
}
}
Variables
{
"batchId": "74332529"
}
Response
{
"data": {
"printBatch": {
"id": "60641705",
"messages": PrintMessageTypeConnection,
"status": "OPEN"
}
}
}
propertiesSearch
Type: [PropertySearchResult!]!
URL: https://api.oeg-kraken.energy/v1/graphql/
Search for properties that are already in Kraken and match the search term.
Arguments
| Name | Description |
|---|---|
|
The search term. It can be an address or a meter point identifier. |
Query
query PropertiesSearch($searchTerm: String!) {
propertiesSearch(searchTerm: $searchTerm) {
property {
...PropertyTypeFragment
}
score
}
}
Variables
{
"searchTerm": "edge-they-allow-lot-nearly"
}
Response
{
"data": {
"propertiesSearch": [
{
"property": PropertyType,
"score": "1.0"
}
]
}
}
property
Type: PropertyType
URL: https://api.oeg-kraken.energy/v1/graphql/
A property with the given ID. Usually associated with supply points.
Arguments
| Name | Description |
|---|---|
|
The property ID. |
Query
query Property($id: ID!) {
property(id: $id) {
address
ancestors {
...PropertyConnectionFragment
}
availableSmets2InstallationTimeslots {
...Smets2InstallationTimeslotTypeFragment
}
coordinates {
...CoordinatesTypeFragment
}
descendants {
...PropertyConnectionFragment
}
electricityMeterPoints {
...ElectricityMeterPointTypeFragment
}
embeddedNetwork {
...EmbeddedNetworkTypeFragment
}
gasMeterPoints {
...GasMeterPointTypeFragment
}
id
isChangeOfTenancyOngoing
isSmets2InstallationAllowed
label
measurements {
...MeasurementConnectionFragment
}
occupancyPeriods {
...OccupancyPeriodTypeFragment
}
parent {
...PropertyInterfaceFragment
}
postcode
richAddress {
...PropertyRichAddressTypeFragment
}
smartDeviceNetworks {
...SmartMeterDeviceNetworkTypeFragment
}
splitAddress
wanCoverage
}
}
Variables
{
"id": "97549445"
}
Response
{
"data": {
"property": {
"address": "heart-interest-administration-fire-around",
"ancestors": PropertyConnection,
"availableSmets2InstallationTimeslots": [Smets2InstallationTimeslotType],
"coordinates": CoordinatesType,
"descendants": PropertyConnection,
"electricityMeterPoints": [ElectricityMeterPointType],
"embeddedNetwork": EmbeddedNetworkType,
"gasMeterPoints": [GasMeterPointType],
"id": "42984033",
"isChangeOfTenancyOngoing": true,
"isSmets2InstallationAllowed": true,
"label": "anyone-especially-candidate-season-its",
"measurements": MeasurementConnection,
"occupancyPeriods": [OccupancyPeriodType],
"parent": PropertyInterface,
"postcode": "join-police-computer-region-its",
"richAddress": PropertyRichAddressType,
"smartDeviceNetworks": [SmartMeterDeviceNetworkType],
"splitAddress": ["finish-human-brother-represent-another"],
"wanCoverage": "HIGH"
}
}
}
propertySearch
Type: [PropertyType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Search for properties that are already in Kraken and match the search term.
Deprecated
The 'propertySearch' field is deprecated.
This query is being deprecated in favour of `propertiesSearch`. The latter returns not only the matched properties but the level of confidence in the results through the `score` field.
- Marked as deprecated on 2023-05-23.
- Scheduled for removal on or after 2024-01-01.
Arguments
| Name | Description |
|---|---|
|
The search term. It can be an address or a meter point identifier. |
Query
query PropertySearch($searchTerm: String!) {
propertySearch(searchTerm: $searchTerm) {
address
ancestors {
...PropertyConnectionFragment
}
availableSmets2InstallationTimeslots {
...Smets2InstallationTimeslotTypeFragment
}
coordinates {
...CoordinatesTypeFragment
}
descendants {
...PropertyConnectionFragment
}
electricityMeterPoints {
...ElectricityMeterPointTypeFragment
}
embeddedNetwork {
...EmbeddedNetworkTypeFragment
}
gasMeterPoints {
...GasMeterPointTypeFragment
}
id
isChangeOfTenancyOngoing
isSmets2InstallationAllowed
label
measurements {
...MeasurementConnectionFragment
}
occupancyPeriods {
...OccupancyPeriodTypeFragment
}
parent {
...PropertyInterfaceFragment
}
postcode
richAddress {
...PropertyRichAddressTypeFragment
}
smartDeviceNetworks {
...SmartMeterDeviceNetworkTypeFragment
}
splitAddress
wanCoverage
}
}
Variables
{
"searchTerm": "later-reason-spend-commercial-then"
}
Response
{
"data": {
"propertySearch": [
{
"address": "happen-involve-car-make-book",
"ancestors": PropertyConnection,
"availableSmets2InstallationTimeslots": [Smets2InstallationTimeslotType],
"coordinates": CoordinatesType,
"descendants": PropertyConnection,
"electricityMeterPoints": [ElectricityMeterPointType],
"embeddedNetwork": EmbeddedNetworkType,
"gasMeterPoints": [GasMeterPointType],
"id": "21482170",
"isChangeOfTenancyOngoing": true,
"isSmets2InstallationAllowed": true,
"label": "thank-who-and-bill-whose",
"measurements": MeasurementConnection,
"occupancyPeriods": [OccupancyPeriodType],
"parent": PropertyInterface,
"postcode": "turn-option-seek-face-expect",
"richAddress": PropertyRichAddressType,
"smartDeviceNetworks": [SmartMeterDeviceNetworkType],
"splitAddress": ["value-up-south-beat-drop"],
"wanCoverage": "HIGH"
}
]
}
}
providerAuthDetails
Type: ProviderAuthDetailsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Auth details (e.g. OAuth 2.0 URI) for the provider (if available).
Deprecated
The 'providerAuthDetails' field is deprecated.
Please use 'startSmartFlexOnboarding' instead.
- Marked as deprecated on 2025-10-30.
- Scheduled for removal on or after 2026-04-30.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/608/
Arguments
| Name | Description |
|---|---|
|
The account number that will be associated with the device. Required for some providers. |
|
The client type the request originated from. Used when oauth_uri is different between web and app. |
|
The device type to get the auth details for (as providers may support multiple). |
|
The ID of the property the device belongs to. |
|
The provider to get the auth details for. |
Query
query ProviderAuthDetails(
$accountNumber: String,
$clientType: ClientType,
$deviceType: KrakenFlexDeviceTypes!,
$propertyId: Int,
$provider: ProviderChoices!
) {
providerAuthDetails(
accountNumber: $accountNumber,
clientType: $clientType,
deviceType: $deviceType,
propertyId: $propertyId,
provider: $provider
) {
oauthUri
}
}
Variables
{
"accountNumber": "A-B0EFD55D",
"clientType": "APP",
"deviceType": "BATTERIES",
"propertyId": 11913437,
"provider": "BYD"
}
Response
{
"data": {
"providerAuthDetails": {
"oauthUri": "to-character-wife-across-create"
}
}
}
providerVirtualKeyDetails
Type: ProviderVirtualKeyDetailsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Virtual key details (e.g. certificate public key) for the provider (if available).
Arguments
| Name | Description |
|---|---|
|
The device type to get the virtual key details for (as providers may support multiple). |
|
The provider to get the virtual key details for. |
Query
query ProviderVirtualKeyDetails(
$deviceType: KrakenFlexDeviceTypes!,
$provider: ProviderChoices!
) {
providerVirtualKeyDetails(
deviceType: $deviceType,
provider: $provider
) {
virtualKeyName
virtualKeyUri
}
}
Variables
{
"deviceType": "BATTERIES",
"provider": "BYD"
}
Response
{
"data": {
"providerVirtualKeyDetails": {
"virtualKeyName": "agency-quickly-but-dog-idea",
"virtualKeyUri": "health-political-base-lay-important"
}
}
}
queryComplexity
Type: QueryComplexityOutputType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the complexity of a query.
Arguments
| Name | Description |
|---|---|
|
Query and relevant variables required to calculate the complexity. |
Query
query QueryComplexity($input: QueryComplexityInputType!) {
queryComplexity(input: $input) {
complexityValue
}
}
Variables
{
"input": QueryComplexityInputType
}
Response
{
"data": {
"queryComplexity": {
"complexityValue": 66
}
}
}
question
Type: String
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the customer feedback survey question.
The possible errors that can be raised are:
- KT-CT-5513: Invalid data.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query Question($formId: Int!) {
question(formId: $formId)
}
Variables
{
"formId": 98232288
}
Response
{
"data": {
"question": "measure-suffer-whether-try-recognize"
}
}
quoteinputparams
Type: [QuoteInputParams]
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns the input parameters required to generate a quote.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Query
query Quoteinputparams(
$city: String,
$houseNumber: String,
$longCity: String,
$postcode: String!,
$street: String,
$validFrom: DateTime
) {
quoteinputparams(
city: $city,
houseNumber: $houseNumber,
longCity: $longCity,
postcode: $postcode,
street: $street,
validFrom: $validFrom
) {
city
electricityNetworkOperatorId
electricityNetworkOperatorName
electricityNetworkOperatorNumber
gasNetworkOperatorId
gasNetworkOperatorName
gasNetworkOperatorNumber
houseNumber
postcode
street
supplierId
tariffId
}
}
Variables
{
"city": "look-hour-top-decade-agent",
"houseNumber": "appear-first-despite-however-they",
"longCity": "rock-order-story-these-assume",
"postcode": "ready-capital-improve-hope-even",
"street": "and-create-relationship-whatever-travel",
"validFrom": "1971-04-15T14:35:29.917517+00:00"
}
Response
{
"data": {
"quoteinputparams": [
{
"city": "now-course-minute-move-class",
"electricityNetworkOperatorId": "21801784",
"electricityNetworkOperatorName": "decision-clearly-price-I-executive",
"electricityNetworkOperatorNumber": "character-between-watch-remain-involve",
"gasNetworkOperatorId": "33517434",
"gasNetworkOperatorName": "walk-design-light-produce-blue",
"gasNetworkOperatorNumber": "ten-if-difference-camera-media",
"houseNumber": "management-produce-item-teach-easy",
"postcode": "week-employee-identify-hit-sort",
"street": "director-total-tend-Congress-test",
"supplierId": "94559579",
"tariffId": "56238524"
}
]
}
}
quotingParamDefinitionsForProductOffering
Type: QuotedOfferingParamsType
URL: https://api.oeg-kraken.energy/v1/graphql/
The possible errors that can be raised are:
- KT-CT-12403: Product offering not found.
- KT-CT-12404: Product offering has expired.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The identifier of the product offering. |
Query
query QuotingParamDefinitionsForProductOffering($productOfferingIdentifier: ID) {
quotingParamDefinitionsForProductOffering(productOfferingIdentifier: $productOfferingIdentifier) {
offeringComponents {
...QuotedOfferingParamsTypeFragment
}
offeringIdentifier
productComponents {
...QuotedProductComponentTypeFragment
}
}
}
Variables
{
"productOfferingIdentifier": "84312925"
}
Response
{
"data": {
"quotingParamDefinitionsForProductOffering": {
"offeringComponents": [QuotedOfferingParamsType],
"offeringIdentifier": "74505701",
"productComponents": [QuotedProductComponentType]
}
}
}
rateLimitInfo
Type: CombinedRateLimitInformation
URL: https://api.oeg-kraken.energy/v1/graphql/
Combined information about points-allowance rate limiting and request-specific rate limiting.
Query
query RateLimitInfo {
rateLimitInfo {
fieldSpecificRateLimits {
...FieldSpecificRateLimitInformationConnectionTypeConnectionFragment
}
pointsAllowanceRateLimit {
...PointsAllowanceRateLimitInformationFragment
}
}
}
Response
{
"data": {
"rateLimitInfo": {
"fieldSpecificRateLimits": FieldSpecificRateLimitInformationConnectionTypeConnection,
"pointsAllowanceRateLimit": PointsAllowanceRateLimitInformation
}
}
}
registeredKrakenflexDevice
Type: KrakenFlexDeviceType
URL: https://api.oeg-kraken.energy/v1/graphql/
A device registered with KrakenFlex for a given account.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'registeredKrakenflexDevice' field is deprecated.
Please use 'devices' instead.
- Marked as deprecated on 2024-04-23.
- Scheduled for removal on or after 2026-03-01.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/677/
Arguments
| Name | Description |
|---|---|
|
Query
query RegisteredKrakenflexDevice($accountNumber: String!) {
registeredKrakenflexDevice(accountNumber: $accountNumber) {
chargePointMake
chargePointModel
chargePointPowerInKw
createdAt
hasToken
krakenflexDeviceId
provider
stateOfChargeLimit {
...StateOfChargeLimitFragment
}
status
suspended
testDispatchFailureReason
vehicleBatterySizeInKwh
vehicleMake
vehicleModel
}
}
Variables
{
"accountNumber": "A-790A785D"
}
Response
{
"data": {
"registeredKrakenflexDevice": {
"chargePointMake": "large-house-south-parent-that",
"chargePointModel": "near-record-account-onto-become",
"chargePointPowerInKw": "1.0",
"createdAt": "2022-09-12T22:20:48.235379+00:00",
"hasToken": true,
"krakenflexDeviceId": "27549466",
"provider": "BYD",
"stateOfChargeLimit": StateOfChargeLimit,
"status": "prevent-paper-president-group-assume",
"suspended": true,
"testDispatchFailureReason": "NONE",
"vehicleBatterySizeInKwh": "1.0",
"vehicleMake": "even-today-enjoy-now-start",
"vehicleModel": "least-student-but-carry-look"
}
}
}
retentionQuote
Type: RetentionQuoteType
URL: https://api.oeg-kraken.energy/v1/graphql/
The quoted products already offered to the customer for retention.
The possible errors that can be raised are:
- KT-CT-3823: Unauthorized.
- KT-CT-4719: No supply point found for identifier provided.
- KT-DE-4603: Required field missing from quote retention message.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query RetentionQuote($input: RetentionQuoteInput!) {
retentionQuote(input: $input) {
quotedProductIds
quotedProductSwitchExpiryDate
quotedProductSwitchUrl
}
}
Variables
{
"input": RetentionQuoteInput
}
Response
{
"data": {
"retentionQuote": {
"quotedProductIds": ["away-information-only-article-several"],
"quotedProductSwitchExpiryDate": "too-personal-share-war-lawyer",
"quotedProductSwitchUrl": "mention-thousand-quality-everybody-operation"
}
}
}
returnSchedule
Type: [DepositReturnScheduleOutput]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get deposit agreement related return schedules for a given account.
The possible errors that can be raised are:
- KT-CT-4177: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Query
query ReturnSchedule($accountNumber: String!) {
returnSchedule(accountNumber: $accountNumber) {
amount
dueDate
status
}
}
Variables
{
"accountNumber": "A-FF8BCE6C"
}
Response
{
"data": {
"returnSchedule": [
{
"amount": 16,
"dueDate": "1970-02-15",
"status": "class-society-live-rise-either"
}
]
}
}
salesFunnelByCode
Type: SalesFunnel
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the sales funnel by input.
The possible errors that can be raised are:
- KT-CT-8912: Funnel not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Input fields for retrieving the sales funnel. |
Query
query SalesFunnelByCode($input: SalesFunnelInput!) {
salesFunnelByCode(input: $input) {
code
collections {
...CollectionFragment
}
funnelType
name
rules {
...SalesFunnelRuleFragment
}
stages {
...SalesFunnelStageFragment
}
status
uncollectedFields {
...FunnelFieldFragment
}
}
}
Variables
{
"input": SalesFunnelInput
}
Response
{
"data": {
"salesFunnelByCode": {
"code": "lay-better-your-economic-various",
"collections": [Collection],
"funnelType": "LEAD",
"name": "company-green-benefit-daughter-somebody",
"rules": [SalesFunnelRule],
"stages": [SalesFunnelStage],
"status": "DRAFT",
"uncollectedFields": [FunnelField]
}
}
}
salesFunnels
Type: [SalesFunnel]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get all sales funnels.
Arguments
| Name | Description |
|---|---|
|
Input fields for retrieving the sales funnels. |
Query
query SalesFunnels($input: SalesFunnelsInput) {
salesFunnels(input: $input) {
code
collections {
...CollectionFragment
}
funnelType
name
rules {
...SalesFunnelRuleFragment
}
stages {
...SalesFunnelStageFragment
}
status
uncollectedFields {
...FunnelFieldFragment
}
}
}
Variables
{
"input": SalesFunnelsInput
}
Response
{
"data": {
"salesFunnels": [
{
"code": "analysis-action-share-sometimes-husband",
"collections": [Collection],
"funnelType": "LEAD",
"name": "least-table-great-her-machine",
"rules": [SalesFunnelRule],
"stages": [SalesFunnelStage],
"status": "DRAFT",
"uncollectedFields": [FunnelField]
}
]
}
}
searchLead
Type: LeadIdType
URL: https://api.oeg-kraken.energy/v1/graphql/
Search and return the identifiers of a lead.
The possible errors that can be raised are:
- KT-CT-8920: Search filters are invalid.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
Filters to search for leads. All passed filters will be checked against the lead. |
Query
query SearchLead($filters: SearchLeadFilters!) {
searchLead(filters: $filters) {
number
}
}
Variables
{
"filters": SearchLeadFilters
}
Response
{
"data": {
"searchLead": {
"number": "always-minute-drop-sister-wind"
}
}
}
siteworksRequests
Type: CoreSiteworksRequestConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
A query to get a subset of Requests.
Deprecated
The 'siteworksRequests' field is deprecated.
Please use getOnSiteJobsRequests instead.
- Marked as deprecated on 2026-03-01.
- Scheduled for removal on or after 2026-09-01.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
Only requests created after this datetime will be included. |
|
|
|
A list of request IDs. If provided, only these requests will be returned. |
|
|
|
Only requests with a status in this list will be included. |
Query
query SiteworksRequests(
$after: String,
$before: String,
$createdAfter: DateTime,
$first: Int,
$ids: [UUID],
$last: Int,
$statuses: [RequestStatus]
) {
siteworksRequests(
after: $after,
before: $before,
createdAfter: $createdAfter,
first: $first,
ids: $ids,
last: $last,
statuses: $statuses
) {
edgeCount
edges {
...CoreSiteworksRequestConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"createdAfter": "1972-03-30T19:18:28.293901+00:00",
"first": 10,
"ids": ["fdd1a782-38b2-42d2-b4fc-5e1c6f66bf90"],
"last": 10,
"statuses": "APPROVAL_PENDING"
}
Response
{
"data": {
"siteworksRequests": {
"edgeCount": 19,
"edges": CoreSiteworksRequestConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 94
}
}
}
smartFlexDeviceSupplyPoint
Type: SmartFlexDeviceSupplyPointType
URL: https://api.oeg-kraken.energy/v1/graphql/
The supply point linked to the SmartFlex device.
Arguments
| Name | Description |
|---|---|
|
The SmartFlex device ID to get the supply point details for. |
Query
query SmartFlexDeviceSupplyPoint($smartFlexDeviceId: String) {
smartFlexDeviceSupplyPoint(smartFlexDeviceId: $smartFlexDeviceId) {
importSupplyPointId
smartFlexDeviceId
}
}
Variables
{
"smartFlexDeviceId": "84525033"
}
Response
{
"data": {
"smartFlexDeviceSupplyPoint": {
"importSupplyPointId": "99269882",
"smartFlexDeviceId": "22637176"
}
}
}
smartFlexOnboardingWizards
Type: [SmartFlexOnboardingWizard!]
URL: https://api.oeg-kraken.energy/v1/graphql/
A list of wizards for onboarding devices for an account and property.
The possible errors that can be raised are:
- KT-CT-4321: Serializer validation error.
- KT-CT-1111: Unauthorized.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number, e.g. A-12345678. |
|
Include cancelled wizards. |
|
Include completed wizards. |
|
Filters for onboarding wizards that can be resumed. List limits to one resumable wizard. |
|
Only list wizards for this property. |
|
To get a specific wizard by ID, if it exists. |
Query
query SmartFlexOnboardingWizards(
$accountNumber: String!,
$includeCancelled: Boolean,
$includeCompleted: Boolean,
$isResumable: Boolean,
$propertyId: Int,
$wizardId: ID
) {
smartFlexOnboardingWizards(
accountNumber: $accountNumber,
includeCancelled: $includeCancelled,
includeCompleted: $includeCompleted,
isResumable: $isResumable,
propertyId: $propertyId,
wizardId: $wizardId
) {
backendScreen {
... on ComponentListType {
...ComponentListTypeFragment
}
... on Dashboard {
...DashboardFragment
}
... on FormScreenType {
...FormScreenTypeFragment
}
... on GenericBackendScreen {
...GenericBackendScreenFragment
}
}
completedSteps {
...SmartFlexOnboardingStepInterfaceFragment
}
currentStep {
...SmartFlexOnboardingStepInterfaceFragment
}
deviceType
displayName
id
resumable {
...SmartFlexResumableFragment
}
}
}
Variables
{
"accountNumber": "A-1925DF83",
"includeCancelled": true,
"includeCompleted": true,
"isResumable": true,
"propertyId": 50986320,
"wizardId": "70000145"
}
Response
{
"data": {
"smartFlexOnboardingWizards": [
{
"backendScreen": ComponentListType,
"completedSteps": SmartFlexOnboardingStepInterface,
"currentStep": SmartFlexOnboardingStepInterface,
"deviceType": "BATTERIES",
"displayName": "consider-not-condition-popular-ball",
"id": "81028156",
"resumable": SmartFlexResumable
}
]
}
}
streetAddressAutocomplete
Type: StreetRegistryConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Auto-complete street addresses by postal code and partial street name. Returns matching street registry entries with full address details, including municipality and network operator information. Results are ordered by similarity to the provided street name.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
Optional city filter for additional filtering. |
|
|
|
|
|
The postal code to filter by (5 digits). |
|
Partial street name for auto-completion matching. |
|
The datetime to check validity against. Defaults to the current datetime if not provided. |
Query
query StreetAddressAutocomplete(
$after: String,
$before: String,
$city: String,
$first: Int,
$last: Int,
$postalCode: String!,
$streetName: String!,
$validAt: DateTime
) {
streetAddressAutocomplete(
after: $after,
before: $before,
city: $city,
first: $first,
last: $last,
postalCode: $postalCode,
streetName: $streetName,
validAt: $validAt
) {
edgeCount
edges {
...StreetRegistryEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"city": "should-such-candidate-cold-reach",
"first": 10,
"last": 10,
"postalCode": "respond-role-majority-himself-whether",
"streetName": "effort-expert-agent-be-personal",
"validAt": "2007-03-31T00:59:04.111559+00:00"
}
Response
{
"data": {
"streetAddressAutocomplete": {
"edgeCount": 29,
"edges": StreetRegistryEdge,
"pageInfo": PageInfo,
"totalCount": 38
}
}
}
supplyPoint
Type: SupplyPointType
URL: https://api.oeg-kraken.energy/v1/graphql/
Get a supply point by its market specific id.
The possible errors that can be raised are:
- KT-CT-4722: Supply point readings API not configured.
- KT-CT-4719: No supply point found for identifier provided.
- KT-CT-4723: Invalid market name provided.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The market specific supply point id. |
|
The name of the market in which this supply point exists. |
Query
query SupplyPoint(
$externalIdentifier: String!,
$marketName: String!
) {
supplyPoint(
externalIdentifier: $externalIdentifier,
marketName: $marketName
) {
devices {
...DevicesConnectionFragment
}
externalIdentifier
id
marketName
meterPoint {
... on ElectricityMeterPointType {
...ElectricityMeterPointTypeFragment
}
... on GasMeterPointType {
...GasMeterPointTypeFragment
}
}
property {
...PropertyTypeFragment
}
readings {
...ReadingsFragment
}
}
}
Variables
{
"externalIdentifier": "26435997",
"marketName": "particularly-finish-continue-guy-plant"
}
Response
{
"data": {
"supplyPoint": {
"devices": DevicesConnection,
"externalIdentifier": "28187358",
"id": "72156612",
"marketName": "always-hair-lose-buy-report",
"meterPoint": ElectricityMeterPointType,
"property": PropertyType,
"readings": Readings
}
}
}
supplyPoints
Type: SupplyPointConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Get list of supply points.
Arguments
| Name | Description |
|---|---|
|
Filter meter points by account. |
|
|
|
|
|
|
|
|
|
Filter meter points by portfolio. |
Query
query SupplyPoints(
$accountNumber: String,
$after: String,
$before: String,
$first: Int,
$last: Int,
$portfolioNumber: String
) {
supplyPoints(
accountNumber: $accountNumber,
after: $after,
before: $before,
first: $first,
last: $last,
portfolioNumber: $portfolioNumber
) {
edgeCount
edges {
...SupplyPointConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-B1D8CA03",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"portfolioNumber": "P-1667E07A"
}
Response
{
"data": {
"supplyPoints": {
"edgeCount": 56,
"edges": SupplyPointConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 26
}
}
}
taskResult
Type: TaskResult
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the status of a background task.
The possible errors that can be raised are:
- KT-CT-10401: Task not found.
- KT-CT-1113: Disabled GraphQL field requested.
Query
query TaskResult(
$accountNumber: String!,
$taskId: String!
) {
taskResult(
accountNumber: $accountNumber,
taskId: $taskId
) {
error
result
status
}
}
Variables
{
"accountNumber": "A-AAEF1F11",
"taskId": "34609836"
}
Response
{
"data": {
"taskResult": {
"error": "traditional-day-open-chair-stop",
"result": {"key": "value"},
"status": "STARTED"
}
}
}
termsAndConditionsForProduct
Type: [TermsAndConditionsType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the active terms and conditions for a market supply product.
The possible errors that can be raised are:
- KT-CT-8501: No active terms and conditions found for product.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The product code of the market supply product. |
Query
query TermsAndConditionsForProduct($productCode: String!) {
termsAndConditionsForProduct(productCode: $productCode) {
brandCode
effectiveFrom
html
markdown
name
pdfUrl
version
}
}
Variables
{
"productCode": "oil-weight-only-TV-church"
}
Response
{
"data": {
"termsAndConditionsForProduct": {
"brandCode": "fall-other-successful-hit-fund",
"effectiveFrom": "1979-08-26T22:57:02.313784+00:00",
"html": "eye-usually-garden-small-little",
"markdown": "race-too-political-describe-walk",
"name": "report-service-while-pick-strong",
"pdfUrl": "themselves-benefit-law-for-major",
"version": "science-manager-study-spend-up"
}
}
}
termsandconditions
Type: OEDETermsAndConditionsType
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns the terms and conditions based on the code and version. If a brand code is provided without version numbers, the latest terms and conditions are returned.
Query
query Termsandconditions(
$brandCode: String,
$versionMajor: Int,
$versionMinor: Int
) {
termsandconditions(
brandCode: $brandCode,
versionMajor: $versionMajor,
versionMinor: $versionMinor
) {
brandCode
createdAt
effectiveFrom
html
markdown
name
pdfUrl
text
version
}
}
Variables
{
"brandCode": "science-color-head-PM-since",
"versionMajor": 58,
"versionMinor": 87
}
Response
{
"data": {
"termsandconditions": {
"brandCode": "line-professional-street-none-none",
"createdAt": "2022-06-06T14:25:48.532126+00:00",
"effectiveFrom": "1971-11-30T10:43:10.652669+00:00",
"html": "affect-already-financial-Mrs-pay",
"markdown": "race-admit-them-down-whose",
"name": "generation-suddenly-Republican-age-mention",
"pdfUrl": "hour-year-discussion-house-company",
"text": "above-Mrs-per-class-study",
"version": "develop-visit-pull-will-just"
}
}
}
termsandconditionsforproduct
Type: [OEDETermsAndConditionsType]
URL: https://api.oeg-kraken.energy/v1/graphql/
Returns a list of the active terms and conditions for a product.
The possible errors that can be raised are:
- KT-CT-8501: No active terms and conditions found for product.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The code of the product we are interested in. |
Query
query Termsandconditionsforproduct($productCode: String!) {
termsandconditionsforproduct(productCode: $productCode) {
brandCode
createdAt
effectiveFrom
html
markdown
name
pdfUrl
text
version
}
}
Variables
{
"productCode": "stuff-painting-resource-improve-memory"
}
Response
{
"data": {
"termsandconditionsforproduct": [
{
"brandCode": "even-front-understand-bad-strategy",
"createdAt": "2012-02-24T08:15:20.679959+00:00",
"effectiveFrom": "1979-02-08T07:41:32.127532+00:00",
"html": "issue-structure-meeting-meet-mean",
"markdown": "commercial-wrong-security-experience-girl",
"name": "remain-thank-necessary-expert-grow",
"pdfUrl": "name-though-region-difficult-after",
"text": "price-enjoy-theory-civil-you",
"version": "song-education-administration-star-book"
}
]
}
}
thirdPartyViewer
Type: ThirdPartyOrganizationType
URL: https://api.oeg-kraken.energy/v1/graphql/
The currently authenticated third party.
This field requires the Authorization header to be set.
Query
query ThirdPartyViewer {
thirdPartyViewer {
name
permissions {
...ThirdPartyPermissionFragment
}
}
}
Response
{
"data": {
"thirdPartyViewer": {
"name": "near-weight-nation-record-oil",
"permissions": [ThirdPartyPermission]
}
}
}
trigger
Type: Trigger!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the details of a published trigger with a given ID.
The possible errors that can be raised are:
- KT-CT-9904: Trigger not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The ID of the trigger. |
Query
query Trigger($triggerId: ID!) {
trigger(triggerId: $triggerId) {
accounts {
...AccountConnectionTypeConnectionFragment
}
accountsLinkedAt
createdAt
id
messages {
...MessageConnectionFragment
}
processingStatus
triggerTypeCode
}
}
Variables
{
"triggerId": "27238895"
}
Response
{
"data": {
"trigger": {
"accounts": AccountConnectionTypeConnection,
"accountsLinkedAt": "1998-03-16T22:37:29.973742+00:00",
"createdAt": "1990-05-08T04:28:59.102868+00:00",
"id": "85295756",
"messages": MessageConnection,
"processingStatus": "UNPROCESSED",
"triggerTypeCode": "however-any-serious-kind-ready"
}
}
}
userVehicles
Type: [UserVehiclesType]
URL: https://api.oeg-kraken.energy/v1/graphql/
A list of vehicles available to the user.
Note: If the API returns an empty list, there might be a delay between the vehicle being registered in the provider's system, and data being fetched from the vehicle's manufacturer. In such cases, the query should be retried after a few seconds.
The possible errors that can be raised are:
- KT-CT-4314: Unable to get provider details.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'userVehicles' field is deprecated.
Please use 'startSmartFlexOnboarding' instead.
- Marked as deprecated on 2025-10-30.
- Scheduled for removal on or after 2026-04-30.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/608/
Arguments
| Name | Description |
|---|---|
|
|
|
The authentication details required given the chosen provider. |
|
The provider used to authenticate the device (default Enode). |
Query
query UserVehicles(
$accountNumber: String,
$authentication: AuthenticationInput,
$supportedProvider: ProviderChoices
) {
userVehicles(
accountNumber: $accountNumber,
authentication: $authentication,
supportedProvider: $supportedProvider
) {
information {
...VehicleInformationTypeFragment
}
vehicleId
}
}
Variables
{
"accountNumber": "A-E6D67955",
"authentication": AuthenticationInput,
"supportedProvider": "BYD"
}
Response
{
"data": {
"userVehicles": [
{
"information": VehicleInformationType,
"vehicleId": "83735616"
}
]
}
}
validateReferralCode
Type: ReferralClaimCodeType
URL: https://api.oeg-kraken.energy/v1/graphql/
Validate referral claim code.
Arguments
| Name | Description |
|---|---|
|
Referral claim code value. |
Query
query ValidateReferralCode($value: String!) {
validateReferralCode(value: $value) {
accountReferral {
...ReferralTypeFragment
}
createdAt
id
isValid
referralScheme {
...ReferralSchemeTypeFragment
}
value
}
}
Variables
{
"value": "class-back-cut-concern-trouble"
}
Response
{
"data": {
"validateReferralCode": {
"accountReferral": ReferralType,
"createdAt": "2018-10-09T15:27:52.152152+00:00",
"id": 61049919,
"isValid": true,
"referralScheme": ReferralSchemeType,
"value": "defense-hand-mention-student-possible"
}
}
}
vehicleChargingPreferences
Type: VehicleChargingPreferencesType
URL: https://api.oeg-kraken.energy/v1/graphql/
Vehicle charging preference details.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-4339: Your device charging preferences could not be fetched.
- KT-CT-1113: Disabled GraphQL field requested.
Deprecated
The 'vehicleChargingPreferences' field is deprecated.
Please use 'devices.preferences' instead.
- Marked as deprecated on 2024-04-23.
- Scheduled for removal on or after 2026-03-01.
You can read more about this deprecation on:
https://announcements.kraken.tech/announcements/public/675/
Arguments
| Name | Description |
|---|---|
|
Query
query VehicleChargingPreferences($accountNumber: String!) {
vehicleChargingPreferences(accountNumber: $accountNumber) {
maximumSocPercentage
minimumSocPercentage
weekdayTargetSoc
weekdayTargetTime
weekendTargetSoc
weekendTargetTime
}
}
Variables
{
"accountNumber": "A-39CD9757"
}
Response
{
"data": {
"vehicleChargingPreferences": {
"maximumSocPercentage": 34,
"minimumSocPercentage": 64,
"weekdayTargetSoc": 76,
"weekdayTargetTime": "me-staff-dinner-particular-go",
"weekendTargetSoc": 45,
"weekendTargetTime": "alone-author-before-often-system"
}
}
}
verificationStatus
Type: EmailVerificationStatus
URL: https://api.oeg-kraken.energy/v1/graphql/
Check the verification status of a given email address.
Arguments
| Name | Description |
|---|---|
|
The email address to be checked. |
Query
query VerificationStatus($email: String!) {
verificationStatus(email: $email) {
email
status
}
}
Variables
{
"email": "perhaps-laugh-will-market-film"
}
Response
{
"data": {
"verificationStatus": {
"email": "girl-decade-personal-food-watch",
"status": "NOT_SENT"
}
}
}
viewer
Type: AccountUserType
URL: https://api.oeg-kraken.energy/v1/graphql/
The currently authenticated user.
This field requires the Authorization header to be set.
Query
query Viewer {
viewer {
accountUserRoles {
...AccountUserRoleTypeFragment
}
accounts {
...AccountInterfaceFragment
}
address {
...RichAddressTypeFragment
}
alternativePhoneNumbers
businesses {
...BusinessConnectionTypeConnectionFragment
}
consents {
...ConsentTypeFragment
}
createdAt
dateOfBirth
details {
...AccountUserDetailTypeFragment
}
email
familyName
fullName
givenName
hasFamilyIssues
holdMusicChoices {
...TrackOptionTypeFragment
}
id
isActive
isDeceased
isInHardship
isOptedInToWof
label
landline
liveSecretKey
mobile
number
paymentMethods {
...PaymentInstructionConnectionTypeConnectionFragment
}
permissions {
...AccountUserPermissionFragment
}
portfolioIds
portfolioUserRoles {
...PortfolioUserRoleTypeFragment
}
portfolios {
...PortfolioConnectionTypeConnectionFragment
}
preferences {
...AccountUserCommsPreferencesFragment
}
preferredName
pronouns
specialCircumstances {
...SpecialCircumstancesTypeFragment
}
title
}
}
Response
{
"data": {
"viewer": {
"accountUserRoles": [AccountUserRoleType],
"accounts": AccountInterface,
"address": RichAddressType,
"alternativePhoneNumbers": ["fact-organization-yard-wrong-marriage"],
"businesses": BusinessConnectionTypeConnection,
"consents": ConsentType,
"createdAt": "1979-10-08T10:23:28.312492+00:00",
"dateOfBirth": "2020-08-22",
"details": [AccountUserDetailType],
"email": "range-majority-possible-history-public",
"familyName": "Johnson",
"fullName": "prove-opportunity-really-suffer-building",
"givenName": "Kevin",
"hasFamilyIssues": true,
"holdMusicChoices": [TrackOptionType],
"id": "24092792",
"isActive": true,
"isDeceased": true,
"isInHardship": true,
"isOptedInToWof": true,
"label": "deal-interview-claim-together-special",
"landline": "outside-goal-ago-person-pattern",
"liveSecretKey": "owner-away-over-nation-draw",
"mobile": "ten-same-option-short-make",
"number": "country-add-heavy-news-as",
"paymentMethods": PaymentInstructionConnectionTypeConnection,
"permissions": [AccountUserPermission],
"portfolioIds": ["66028249"],
"portfolioUserRoles": [PortfolioUserRoleType],
"portfolios": PortfolioConnectionTypeConnection,
"preferences": AccountUserCommsPreferences,
"preferredName": "everyone-gun-knowledge-growth-film",
"pronouns": "show-beat-beyond-expert-wear",
"specialCircumstances": SpecialCircumstancesType,
"title": "compare-dog-since-consumer-home"
}
}
}
voiceCampaign
Type: VoiceCampaignType!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the voice campaign for a given ID.
The possible errors that can be raised are:
- KT-CT-11501: Voice campaign not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The campaign ID. |
Query
query VoiceCampaign($campaignId: String!) {
voiceCampaign(campaignId: $campaignId) {
campaignItems {
...VoiceCampaignItemConnectionTypeConnectionFragment
}
campaignType
customOutboundPhoneNumber
description
id
name
preventDuplicateRecords
status
tags {
...CallTagConnectionTypeConnectionFragment
}
}
}
Variables
{
"campaignId": "24225513"
}
Response
{
"data": {
"voiceCampaign": {
"campaignItems": VoiceCampaignItemConnectionTypeConnection,
"campaignType": "PREVIEW",
"customOutboundPhoneNumber": "stand-city-painting-exist-age",
"description": "edge-choice-final-question-health",
"id": "90873373",
"name": "see-soon-campaign-require-real",
"preventDuplicateRecords": true,
"status": "ACTIVE",
"tags": CallTagConnectionTypeConnection
}
}
}
voiceCampaigns
Type: VoiceCampaignConnectionTypeConnection!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get voice campaigns.
Arguments
| Name | Description |
|---|---|
|
|
|
|
|
Filter by campaign type. |
|
|
|
|
|
Filter by campaign name. |
|
Filter by campaign status. |
Query
query VoiceCampaigns(
$after: String,
$before: String,
$campaignType: TypeOfVoiceCampaign,
$first: Int,
$last: Int,
$name: String,
$status: CampaignStatus
) {
voiceCampaigns(
after: $after,
before: $before,
campaignType: $campaignType,
first: $first,
last: $last,
name: $name,
status: $status
) {
edgeCount
edges {
...VoiceCampaignConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"campaignType": "PREVIEW",
"first": 10,
"last": 10,
"name": "tonight-population-whole-school-western",
"status": "ACTIVE"
}
Response
{
"data": {
"voiceCampaigns": {
"edgeCount": 4,
"edges": VoiceCampaignConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 35
}
}
}
vouchersBalanceDetail
Type: VouchersBalanceDetail
URL: https://api.oeg-kraken.energy/v1/graphql/
Query the detail of vouchers balance for an account.
The possible errors that can be raised are:
- KT-CT-1111: Unauthorized.
- KT-CT-4178: No account found with given account number.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The account number. |
Query
query VouchersBalanceDetail($accountNumber: ID!) {
vouchersBalanceDetail(accountNumber: $accountNumber) {
redeemableInFuture
redeemableToday
}
}
Variables
{
"accountNumber": "A-DA9BAEA6"
}
Response
{
"data": {
"vouchersBalanceDetail": {
"redeemableInFuture": 35,
"redeemableToday": 77
}
}
}
vouchersForAccount
Type: VoucherPurchaseConnectionTypeConnection
URL: https://api.oeg-kraken.energy/v1/graphql/
Query the voucher purchases for an account.
Arguments
| Name | Description |
|---|---|
|
The account number. |
|
|
|
An optional date to limit the response to vouchers that are available before the particular date (exclusive). |
|
An optional date to limit the response to vouchers that are available from the particular date (inclusive) onwards. |
|
|
|
|
|
|
|
An optional date to limit the response to vouchers that have been purchased before the particular date (exclusive). |
|
An optional date to limit the response to vouchers that have been purchased from the particular date (inclusive) onwards. |
|
Whether to only return vouchers that can be redeemable. |
Query
query VouchersForAccount(
$accountNumber: ID!,
$after: String,
$availableBeforeDate: Date,
$availableFromDate: Date,
$before: String,
$first: Int,
$last: Int,
$purchasedBeforeDate: Date,
$purchasedFromDate: Date,
$redeemableOnly: Boolean!
) {
vouchersForAccount(
accountNumber: $accountNumber,
after: $after,
availableBeforeDate: $availableBeforeDate,
availableFromDate: $availableFromDate,
before: $before,
first: $first,
last: $last,
purchasedBeforeDate: $purchasedBeforeDate,
purchasedFromDate: $purchasedFromDate,
redeemableOnly: $redeemableOnly
) {
edgeCount
edges {
...VoucherPurchaseConnectionTypeEdgeFragment
}
pageInfo {
...PageInfoFragment
}
totalCount
}
}
Variables
{
"accountNumber": "A-AC6F7A0E",
"after": "YXJyYXljb25uZWN0aW9uOjEw=",
"availableBeforeDate": "2013-09-17",
"availableFromDate": "1985-09-01",
"before": "YXJyYXljb25uZWN0aW9uOjEw=",
"first": 10,
"last": 10,
"purchasedBeforeDate": "2023-02-08",
"purchasedFromDate": "2013-02-16",
"redeemableOnly": true
}
Response
{
"data": {
"vouchersForAccount": {
"edgeCount": 39,
"edges": VoucherPurchaseConnectionTypeEdge,
"pageInfo": PageInfo,
"totalCount": 20
}
}
}
workSchedule
Type: WorkScheduleType!
URL: https://api.oeg-kraken.energy/v1/graphql/
Get the work schedule with the given identifier.
The possible errors that can be raised are:
- KT-CT-11804: Work schedule not found.
- KT-CT-1113: Disabled GraphQL field requested.
Arguments
| Name | Description |
|---|---|
|
The identifier of the work schedule (also known as the 'slug'). |
Query
query WorkSchedule($identifier: String!) {
workSchedule(identifier: $identifier) {
identifier
isOpen
isPublicHoliday
name
openOrClosedReason
}
}
Variables
{
"identifier": "94828656"
}
Response
{
"data": {
"workSchedule": {
"identifier": "45164553",
"isOpen": true,
"isPublicHoliday": true,
"name": "eat-manage-approach-more-college",
"openOrClosedReason": "CLOSED_DUE_TO_PUBLIC_HOLIDAY"
}
}
}
Authentication Server
authorizedApplications
Type: [AuthorizedApplication]
URL: https://auth.oeg-kraken.energy/graphql/
Get all the confidential-client applications the current user has authorized.
Deprecated
The 'authorizedApplications' field is deprecated.
Schema is being removed, but will be available in the main API site.
- Marked as deprecated on 2025-10-15.
- Scheduled for removal on or after 2025-10-30.
Query
query AuthorizedApplications {
authorizedApplications {
clientId
name
}
}
Response
{
"data": {
"authorizedApplications": [
{
"clientId": "10551652",
"name": "anyone-thought-available-environment-reveal"
}
]
}
}
krakenVersion
Type: KrakenVersionType
URL: https://auth.oeg-kraken.energy/graphql/
The current version of kraken.
Query
query KrakenVersion {
krakenVersion {
SHA
isPinned
number
}
}
Response
{
"data": {
"krakenVersion": {
"SHA": "later-difficult-decide-idea-tax",
"isPinned": true,
"number": "people-church-feel-far-star"
}
}
}
mfaDevices
Type: [MfaDevice]
URL: https://auth.oeg-kraken.energy/graphql/
Get all MFA devices for the current user.
Deprecated
The 'mfaDevices' field is deprecated.
Schema is being removed, but will be available in the main API site.
- Marked as deprecated on 2025-10-15.
- Scheduled for removal on or after 2025-10-30.
Query
query MfaDevices {
mfaDevices {
deviceType
isConfirmed
}
}
Response
{
"data": {
"mfaDevices": [
{
"deviceType": "shake-shoulder-beat-son-baby",
"isConfirmed": true
}
]
}
}