Get single order

If you know the contract number of a particular order, you can use this endpoint to retrieve the order details. This can be useful to follow the order processing and track status changes. See order states for an explanation about the different order states.

Authorizations

Authorization

string

header

required

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

Path Parameters

contractNumber

string

required

The unique identifier of the contract

Response

200 - application/json

API response DTO with data.

isSuccess

boolean

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

Optional reference URI to point to the resulting resource.

data

object

Returned data instance.

Hide child attributes

data.order

object

Current contract status

Hide child attributes

data.order.customerNumber

string

required

Read-only customer number provided by the API

Example:

"123456789"

data.order.emailAddress

string

required

Email Address of the customer

Example:

"[email protected]"

data.order.tariffName

string

required

Name of the selected tariff for this order

Example:

"rabot.smart"

data.order.contractNumber

string

required

Order / Contract number

Example:

"987654321"

data.order.firstName

string | null

First name of the customer or NULL if business customer.

Example:

"Max"

data.order.lastName

string | null

Last name of the customer or NULL if business customer.

Example:

"Mustermann"

data.order.businessName

string | null

Business name or NULL if private customer

Example:

null

data.order.meterNumber

string | null

Meter number as provided as part of the order, can be null

Example:

"12LN6786454"

data.order.meLoIdentifier

string | null

Metering Location identifier or NULL if not provided

Example:

"DE12345678901234567890"

data.order.maLoIdentifier

string | null

Market Location identifier or NULL if not provided

Example:

"99987999749"

data.order.deliveryAddress

object

Delivery address of the customer

Hide child attributes

data.order.deliveryAddress.title

string | null

Academic title or NULL if none

Example:

"Dr."

data.order.deliveryAddress.firstName

string | null

First name or NULL if business address

Example:

"Thomas"

data.order.deliveryAddress.lastName

string | null

Last name or NULL if business address

Example:

"Mustermann"

data.order.deliveryAddress.businessName

string | null

Business name in case of business address or NULL if person

Example:

null

data.order.deliveryAddress.gender

enum<string>

Gender of the address holder

Available options:

Male,

Female,

Other

data.order.deliveryAddress.extension

string | null

Address extension

Example:

null

data.order.deliveryAddress.streetName

string

Street name

Example:

"Grüner Weg"

data.order.deliveryAddress.houseNumber

string

House number or NULL if none

Example:

"42"

data.order.deliveryAddress.city

string

Name of the city

Example:

"Berlin"

data.order.deliveryAddress.postCode

string

Postcode in valid format

Example:

"14109"

data.order.deliveryAddress.countryCode

string

ISO 3166 A2 code of the country

Example:

"DE"

data.order.state

enum<string>

State of the order processing

Available options:

Open,

Delivery,

Unspecified,

PendingDelivery,

Cancelled,

Rejected,

Revoked,

Processing

Example:

"Delivery"

data.order.processingInfo

string | null

Human-readable information about the processing of Order.

Example:

"Exported to MaKo provider"

data.order.denialReason

enum<string>

Reason for the order denial, if applicable

Available options:

Dunning,

InsufficientSolvency,

ContractCommitment,

Duplicate,

UnsuccessfulSupplierChange,

Other

Example:

"Other"

data.order.deliveryState

object

Last delivery state update information for this order.

Hide child attributes

data.order.deliveryState.startDate

string<date> | null

Delivery start date.

Example:

"2024-02-01"

data.order.deliveryState.endDate

string<date> | null

Delivery end date or NULL if not specified.

Example:

null

data.order.deliveryState.state

enum<string>

Current delivery state

Available options:

None,

Delivery,

DeliveryPending,

CancelledDelivery,

CancelledPendingDelivery,

Cancelled,

Denied,

Revoked,

InChangeProcess,

Unknown

Example:

"InChangeProcess"

data.order.deliveryState.message

string | null

Message received with the delivery state change from MaKo operator.

Example:

null

data.order.deliveryState.denialReason

enum<string>

Reason for denial if state is "Denied" or NULL otherwise.

Available options:

Dunning,

InsufficientSolvency,

ContractCommitment,

Duplicate,

UnsuccessfulSupplierChange,

Other

Example:

null

data.order.deliveryState.cancellationReason

enum<string>

Cancellation reason if state is "Canceled" or NULL otherwise.

Available options:

None,

Dunning,

OtherSupplier,

CustomerSupplierChange,

CustomerRelocation,

Decommissioning,

Unknown,

CustomerProduct,

CustomerPrice,

CustomerService,

CustomerMisc,

CustomerPriceChange

Example:

null

data.order.actualDateOfDelivery

string<date> | null

Start of delivery date, as confirmed by DSO and previous supplier, null if not known (yet)

Example:

"2025-04-01"

data.order.endDateOfDelivery

string<date> | null

End of delivery date, if contract is canceled

Example:

null

data.order.contractSignatureDate

string<date-time> | null

deprecated

Contract signature date, as provided in order creation request

Example:

"2025-02-23 14:24:15"

data.order.contractSignedAt

string<date-time> | null

Contract signature date, as provided in order creation request

Example:

"2025-02-23 14:24:15"

data.order.estimatedYearlyConsumption

integer<int32> | null

Estimated yearly consumption, in kWh

Example:

3500

data.order.previousYearConsumption

integer<int32> | null

Previous year consumption, in kWh

Example:

4200

Introduction

Get Started

Quickstart

Guides

Updates

API reference

Authorizations

Path Parameters

Response