List contracts - RABOT Partner API

GET

partner

customers

{customerNumber}

contracts

Get contracts for given customer (number)

curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts \
  --header 'Authorization: Bearer <token>'

{
  "isSuccess": true,
  "message": null,
  "error": [
    {
      "severity": "Error",
      "code": "validation-failed",
      "message": "First name is required for non-business customers.",
      "details": null
    }
  ],
  "refUri": "<string>",
  "data": [
    {
      "contractNumber": "<string>",
      "tariffName": "Rabot.smart",
      "contractState": "Open",
      "name": "Home",
      "deliveryAddress": {
        "title": "Dr.",
        "firstName": "Thomas",
        "lastName": "Mustermann",
        "businessName": null,
        "extension": null,
        "streetName": "Grüner Weg",
        "houseNumber": "42",
        "city": "Berlin",
        "postCode": "14109",
        "countryCode": "DE"
      },
      "billingAddress": {
        "title": "Dr.",
        "firstName": "Thomas",
        "lastName": "Mustermann",
        "businessName": null,
        "extension": null,
        "streetName": "Grüner Weg",
        "houseNumber": "42",
        "city": "Berlin",
        "postCode": "14109",
        "countryCode": "DE"
      },
      "bankDetail": {
        "accountHolder": "Thomas Heinrich Mustermann",
        "iban": "DE89370400440532013000",
        "bic": "DEUTDEFF",
        "bankName": "Deutsche Bank",
        "hasAcceptedDirectDebit": true
      },
      "meterNumber": "12LN6786454",
      "meLoIdentifier": "DE12345678901234567890",
      "maLoIdentifier": "99987999749",
      "actualDateOfDelivery": "2025-03-01",
      "endDateOfDelivery": null,
      "cancellationPeriod": 1,
      "cancellationPeriodUnit": "Month",
      "durationPeriod": 1,
      "durationPeriodUnit": "Month",
      "renewalPeriod": 1,
      "renewalPeriodUnit": "Month",
      "expectedAnnualConsumptionInKwhPerYear": 3500,
      "accountingMethod": "IMSy (TAF7)",
      "distributionSystemOperatorCode": "9907248000001",
      "distributionSystemOperatorName": "SWM Infrastruktur GmbH & Co. KG",
      "previousSupplierCode": "9910660000004",
      "previousSupplierName": "Octopus Energy Germany",
      "paragraph14AInfo": {
        "isModule1InUse": true,
        "isModule2InUse": true,
        "isModule3InUse": true
      }
    }
  ],
  "count": 10,
  "hasMoreItems": true
}

This endpoint allows you to retrieve all contracts for a particular customer. A contract is only listed here after it has been confirmed, i.e. the contract confirmation has been sent out to the customer and a date for the start of delivery has been set. By default, the API returns only the first 10 records. Use offset and limit request parameters for paging.

Requires role:application, role:customer-support or role: finance-reporting scope or Linked relation on customer level.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerNumber

string

required

Customer number

Query Parameters

offset

integer<int32>

default:0

Offset of the page.

limit

integer<int32>

default:10

Size of the page.

Response

200 - application/json

API response DTO with a list of items.

isSuccess

boolean

read-only

Success status of the operation based on status code (2xx range).

Example:

true

message

string | null

Optional message to provide additional information about the operation result.

Example:

null

error

object[] | null

Optional error details in case of an error(s).

Hide child attributes

error.severity

enum<string>

Severity of the error.

Available options:

Error,

Warning,

Notice

Example:

"Error"

error.code

string

Internal error code for client processing.

Example:

"validation-failed"

error.message

string

Error message.

Example:

"First name is required for non-business customers."

error.details

string | null

Additional details about the error.

Example:

null

refUri

string<uri> | null

read-only

Optional reference URI to point to the resulting resource.

data

object[]

Returned data instance.

Hide child attributes

data.contractNumber

string

required

Contract number

data.tariffName

string

required

Tariff name

Example:

"Rabot.smart"

data.contractState

enum<string>

required

Contract state

Available options:

Open,

Delivery,

Unspecified,

PendingDelivery,

Cancelled,

Rejected,

Revoked,

Processing

Example:

"Open"

data.name

string | null

Contract name, if added by the user to differentiate multiple contracts

Example:

"Home"

data.deliveryAddress

object | null

Delivery address - the location where the meter is installed

Hide child attributes

data.deliveryAddress.title

string | null

Academic title or NULL if none

Example:

"Dr."

data.deliveryAddress.firstName

string | null

First name or NULL if business address

Example:

"Thomas"

data.deliveryAddress.lastName

string | null

Last name or NULL if business address

Example:

"Mustermann"

data.deliveryAddress.businessName

string | null

Business name in case of business address or NULL if person

Example:

null

data.deliveryAddress.gender

enum<string> | null

Gender of the address holder

Available options:

Male,

Female,

Other

data.deliveryAddress.extension

string | null

Address extension

Example:

null

data.deliveryAddress.streetName

string

Street name

Example:

"Grüner Weg"

data.deliveryAddress.houseNumber

string

House number or NULL if none

Example:

"42"

data.deliveryAddress.city

string

Name of the city

Example:

"Berlin"

data.deliveryAddress.postCode

string

Postcode in valid format

Example:

"14109"

data.deliveryAddress.countryCode

string

ISO 3166 A2 code of the country

Example:

"DE"

data.billingAddress

object | null

Billing address

Hide child attributes

data.billingAddress.title

string | null

Academic title or NULL if none

Example:

"Dr."

data.billingAddress.firstName

string | null

First name or NULL if business address

Example:

"Thomas"

data.billingAddress.lastName

string | null

Last name or NULL if business address

Example:

"Mustermann"

data.billingAddress.businessName

string | null

Business name in case of business address or NULL if person

Example:

null

data.billingAddress.gender

enum<string> | null

Gender of the address holder

Available options:

Male,

Female,

Other

data.billingAddress.extension

string | null

Address extension

Example:

null

data.billingAddress.streetName

string

Street name

Example:

"Grüner Weg"

data.billingAddress.houseNumber

string

House number or NULL if none

Example:

"42"

data.billingAddress.city

string

Name of the city

Example:

"Berlin"

data.billingAddress.postCode

string

Postcode in valid format

Example:

"14109"

data.billingAddress.countryCode

string

ISO 3166 A2 code of the country

Example:

"DE"

data.bankDetail

object | null

Bank details

Hide child attributes

data.bankDetail.accountHolder

string | null

Name of the account holder. When used to create an order, if the value is not provided, the name of the customer from billing address (or delivery address, when billing address is not provided) will be used.

Example:

"Thomas Heinrich Mustermann"

data.bankDetail.iban

string

IBAN of the account.

Example:

"DE89370400440532013000"

data.bankDetail.bic

string | null

BIC of the account.

Example:

"DEUTDEFF"

data.bankDetail.bankName

string | null

Name of the bank.

Example:

"Deutsche Bank"

data.bankDetail.hasAcceptedDirectDebit

boolean

Flags, if the direct debit has been accepted.

Example:

true

data.meterNumber

string | null

Meter number

Example:

"12LN6786454"

data.meLoIdentifier

string | null

Meter location id

Example:

"DE12345678901234567890"

data.maLoIdentifier

string | null

Meter location id

Example:

"99987999749"

data.actualDateOfDelivery

string<date> | null

Start of delivery for this contract

Example:

"2025-03-01"

data.endDateOfDelivery

string<date> | null

End date of delivery, null if contract is not cancelled

Example:

null

data.cancellationPeriod

integer<int32> | null

Cancellation period

Example:

1

data.cancellationPeriodUnit

string | null

Cancellation period unit

Example:

"Month"

data.durationPeriod

integer<int32> | null

Minimum duration of the contract

Example:

1

data.durationPeriodUnit

string | null

Duration period unit

Example:

"Month"

data.renewalPeriod

integer<int32> | null

Renewal period - for how long the contract extends when not cancelled

Example:

1

data.renewalPeriodUnit

string | null

Renewal period unit

Example:

"Month"

data.expectedAnnualConsumptionInKwhPerYear

integer<int32> | null

Expected annual consumption in kWh per year

Example:

3500

data.accountingMethod

string | null

Meter config type

Example:

"IMSy (TAF7)"

data.distributionSystemOperatorCode

string | null

Code of Distribution System Operator

Example:

"9907248000001"

data.distributionSystemOperatorName

string | null

Name of Distribution System Operator

Example:

"SWM Infrastruktur GmbH & Co. KG"

data.previousSupplierCode

string | null

Code of previous supplier

Example:

"9910660000004"

data.previousSupplierName

string | null

Name of previous supplier

Example:

"Octopus Energy Germany"

data.paragraph14AInfo

object | null

Paragraph §14a information

Hide child attributes

data.paragraph14AInfo.isModule1InUse

boolean

required

Module 1 in a use flag.

data.paragraph14AInfo.isModule2InUse

boolean

required

Module 2 in a use flag.

data.paragraph14AInfo.isModule3InUse

boolean

required

Module 3 in a use flag.

count

integer<int32>

read-only

Number of items returned in the list.

Example:

10

hasMoreItems

boolean

Indicates, whether there are more items to be returned in the list, that are not included in the limit of this request.

Example:

true

Contract metricsReturns consumption and pricing history and forecasts for a given contract

⌘I

Get contracts for given customer (number)

curl --request GET \
  --url https://api.rabot-charge.de/partner/v1/customers/{customerNumber}/contracts \
  --header 'Authorization: Bearer <token>'

{
  "isSuccess": true,
  "message": null,
  "error": [
    {
      "severity": "Error",
      "code": "validation-failed",
      "message": "First name is required for non-business customers.",
      "details": null
    }
  ],
  "refUri": "<string>",
  "data": [
    {
      "contractNumber": "<string>",
      "tariffName": "Rabot.smart",
      "contractState": "Open",
      "name": "Home",
      "deliveryAddress": {
        "title": "Dr.",
        "firstName": "Thomas",
        "lastName": "Mustermann",
        "businessName": null,
        "extension": null,
        "streetName": "Grüner Weg",
        "houseNumber": "42",
        "city": "Berlin",
        "postCode": "14109",
        "countryCode": "DE"
      },
      "billingAddress": {
        "title": "Dr.",
        "firstName": "Thomas",
        "lastName": "Mustermann",
        "businessName": null,
        "extension": null,
        "streetName": "Grüner Weg",
        "houseNumber": "42",
        "city": "Berlin",
        "postCode": "14109",
        "countryCode": "DE"
      },
      "bankDetail": {
        "accountHolder": "Thomas Heinrich Mustermann",
        "iban": "DE89370400440532013000",
        "bic": "DEUTDEFF",
        "bankName": "Deutsche Bank",
        "hasAcceptedDirectDebit": true
      },
      "meterNumber": "12LN6786454",
      "meLoIdentifier": "DE12345678901234567890",
      "maLoIdentifier": "99987999749",
      "actualDateOfDelivery": "2025-03-01",
      "endDateOfDelivery": null,
      "cancellationPeriod": 1,
      "cancellationPeriodUnit": "Month",
      "durationPeriod": 1,
      "durationPeriodUnit": "Month",
      "renewalPeriod": 1,
      "renewalPeriodUnit": "Month",
      "expectedAnnualConsumptionInKwhPerYear": 3500,
      "accountingMethod": "IMSy (TAF7)",
      "distributionSystemOperatorCode": "9907248000001",
      "distributionSystemOperatorName": "SWM Infrastruktur GmbH & Co. KG",
      "previousSupplierCode": "9910660000004",
      "previousSupplierName": "Octopus Energy Germany",
      "paragraph14AInfo": {
        "isModule1InUse": true,
        "isModule2InUse": true,
        "isModule3InUse": true
      }
    }
  ],
  "count": 10,
  "hasMoreItems": true
}