Skip to main content
DELETE
Deletes the customer with its subscriptions, credit grants, usage and purchases. Creating the same customerId afterwards starts a new, empty customer.
  • A customer with a paid subscription that isn’t cancelled returns 409 active_paid_subscription, because deleting only Ledger’s record would leave Stripe charging them. Pass deleteInStripe=true to delete the Stripe customer too, which cancels its Stripe subscriptions.
  • Usage events are deleted in Sandbox. In Live they’re kept, as the record of what the customer used.
The SDKs don’t have this method yet, so the examples call the API directly. Needs the Customers permission at Write.

Authorizations

Authorization
string
header
required

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

Query Parameters

customerId
string
required
Required string length: 1 - 255
deleteInStripe
boolean

Also delete the customer's Stripe customer, which cancels its Stripe subscriptions. Required when it has one that isn't canceled.

Response

Customer deleted

customerId
string
required
deleted
boolean
required