Terminate a subscription

curl --request POST \
  --url https://api.nomos.energy/subscriptions/{id}/terminate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "ORDINARY",
  "requested_end_at": "2026-12-31T00:00:00+01:00"
}
'

{
  "intended_end_at": "2026-12-31T00:00:00+01:00"
}

Subscriptions

Terminate a subscription

Terminate a subscription. Three reasons are supported:

ORDINARY: regular termination. requested_end_at is optional; when omitted, the plan’s cancellation period applies.
MOVE_OUT: special termination right tied to a move-out date. intended_end_at is mandatory and still has to leave the grid operator a few working days of notice.
WITHDRAWAL: 14-day cooling-off period (Widerruf) after contract confirmation. The end date is calculated to comply with grid-operator notice periods.

All end dates in the request and response are exclusive midnight Europe/Berlin: from that moment the customer is no longer supplied. The customer’s last day of supply is the day before the named date.

Every termination reason has to clear the grid operator’s working-day notice; ORDINARY additionally has to respect the plan’s cancellation period.

Conflict responses (409) carry a dedicated errors[].code:

invalid_termination_date — the requested date is in the past or violates the plan’s / grid operator’s notice period.
withdrawal_not_allowed — the 14-day withdrawal window has elapsed (or the subscription has no confirmed_at to count from).

POST

/

subscriptions

/

{id}

/

terminate

Terminate a subscription

curl --request POST \
  --url https://api.nomos.energy/subscriptions/{id}/terminate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "ORDINARY",
  "requested_end_at": "2026-12-31T00:00:00+01:00"
}
'

{
  "intended_end_at": "2026-12-31T00:00:00+01:00"
}

Authorizations

Authorization

string

header

required

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

Path Parameters

id

string

required

Example:

"sub_ddltpi1cxql5djzfq058woid"

Body

application/json

The termination request

Option 1
Option 2
Option 3

reason

enum<string>

required

Available options:

ORDINARY

requested_end_at

string<date-time>

Optional exclusive end timestamp. Must be exactly midnight Europe/Berlin (any zone offset accepted as long as the instant is 00:00 Berlin). From that moment the customer is no longer supplied; the last day of supply is the day before. When omitted, the plan's cancellation period applies.

Example:

"2026-12-31T00:00:00+01:00"

Response

The subscription's termination details

reason

enum<string>

required

Available options:

ORDINARY,

MOVE_OUT,

WITHDRAWAL

intended_end_at

string<date-time>

required

Customer-provided or system-calculated exclusive end timestamp at midnight Europe/Berlin. From this instant the customer is no longer supplied.

Example:

"2026-12-31T00:00:00+01:00"

Update a subscription

List subscriptions