Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
The subscription to create
Plan ID
"pln_hq3q12f4ftsxtrm3doe7fedu"
If set to false we will request the cancellation of the previous supplier / grid operator signup to the date provided in intended_start_date. If set to true we will request the next possible date.
true
ID of the previous supplier, possible to obtain via /suppliers
"mp_quxok4kc0rlkjv4cqsdjv09c"
Intended start date of the subscription. Must be a date in the future.
"2024-01-01"
Lead to track attribution of the subscription
"lead_ffsql6afxonqgnplczjnegq9"
Array of additional product orders. Each item has a 'type' and may include an additional object with the same name as the type for its details.
[
{ "type": "smart-meter" },
{
"type": "14a_enwg",
"14a_enwg": { "module_1": true }
}
]
Metadata of the subscription. Store any type of information, custom to your needs. E.g. the user_id
of your in-house user. Restricted to 10KB.
{
"utm_source": "google",
"utm_campaign": "campaign_name",
"user_id": "1234567890"
}
Response
The created subscription details
Type of the object, always 'subscription'
subscription
Unique identifier for the subscription
"sub_rocbrf1u5e48mm0reeqoag90"
ID of the plan
"pln_ctj3tjzc7dywznuw1dy80lb3"
ID of the customer
"cus_a8n8ol7yd4h0wohx824f0bui"
ID of the address
"adr_a7gurqkul8lzzsy1pf9p9388"
ID of the meter
"mtr_azk4zue2ijx4ff1dbjt14m5h"
ID of the payment method
"pm_adc9utqqpcp7tx054l7vg56s2"
Status of the subscription
pending
, active
, ended
"active"
Estimated yearly usage in kWh, provided by the customer in the checkout.
Timestamp when the subscription was created
"2024-03-14T12:00:00Z"
Timestamp when the subscription was updated
"2024-03-14T12:00:00Z"
Timestamp when delivery was started / will start
"2024-03-14T12:00:00Z"
Timestamp when delivery was terminated
"2024-03-14T12:00:00Z"
Timestamp when the subscription was ended / will end
"2024-03-14T12:00:00Z"
ID of the previous supplier
"mp_a0x6jm5h92wde6s5dnuvha4c"
Human-readable identifier for the subscription
"4X44EMKX"
Metadata of the subscription. Store any type of information, custom to your needs. E.g. the user_id
of your in-house user. Restricted to 10KB.
{
"utm_source": "google",
"utm_campaign": "campaign_name",
"user_id": "1234567890"
}