Sign in

v1

latestOpenAPI 3.0.12026-07-243686491.1 MB
Subscriptions

Update subscription

Required scope: subscriptions:write

put/api/v1/subscriptions/{subscriptionId}

Path parameters

subscriptionIdinteger required

Request body

discountPercentagenumber required

Percentage discount to set on the subscription.

discountAbsolutenumber required

Absolute discount to set on the subscription.

nextPurchaseAtstring date-time required

Date when the wallet will next be charged (ISO8601: yyyy-MM-ddTHH:mm:ssZ).

Example request

{
  "nextPurchaseAt": "2025-10-22T09:30:03Z",
  "serviceConfig": {
    "payoutPerKwh": 1.29,
    "priceIncludesVat": true,
    "additionalFeeAbsolute": 0.5,
    "roamingAdditionalFeeAbsolute": 0.5
  }
}

Response

The updated subscription

idinteger

Id of the subscription

state'pending' | 'active' | 'paused' | 'cancelling' | 'cancelled' | 'unpaid' | 'other' required
nextPurchaseAtstring date-time nullable

Date of next purchase

cancelledAtstring date-time nullable

Subscription cancellation date

endAtstring date-time nullable

Subscription end date

discountPercentagenumber double

Discount percentage

discountAbsolutenumber double

Discount absolute

discountAmountnumber double

Discount amount

originalAmountnumber double

Original amount

totalAmountnumber double

Total amount

purchaseCountinteger

Number of purchases

chargePointsinteger

Number of charge points

customerIdinteger

The id of the customer

customerType'team' | 'charge-point' | 'operator' | 'other' required

Enumerate the various subscription customer types

planIdinteger

Plan id

createdAtstring date-time required

Subscription creation date

updatedAtstring date-time required

Subscription update date

canCancelboolean

Indicates if the subscription can be cancelled

notestring nullable

A note on the subscription

deletedAtstring date-time nullable

Subscription marked as deleted date

Example response

{
  "id": 1,
  "nextPurchaseAt": "2023-05-12T15:56:45.99Z",
  "cancelledAt": "2023-05-12T15:56:45.99Z",
  "endAt": "2023-05-12T15:56:45.99Z",
  "validityPeriod": {
    "from": "2024-01-01T00:00:00Z",
    "to": "2024-12-31T23:59:59Z"
  },
  "discountPercentage": 7.5,
  "discountAbsolute": 7.5,
  "discountAmount": 7.5,
  "originalAmount": 7.5,
  "totalAmount": 7.5,
  "purchaseCount": 5,
  "chargePoints": 5,
  "customerId": 1,
  "planId": 42,
  "serviceConfig": {
    "payoutPerKwh": 1.29,
    "priceIncludesVat": true,
    "additionalFeeAbsolute": 0.5,
    "roamingAdditionalFeeAbsolute": 0.5
  },
  "createdAt": "2023-05-12T15:56:45.99Z",
  "updatedAt": "2023-05-12T15:56:45.99Z",
  "canCancel": true,
  "note": "Monthly plan for fleet",
  "deletedAt": "2023-05-12T15:56:45.99Z"
}