Sample - Stripe API
DELETE/v1/plans/{plan}

Delete a plan

Deletes a plan from the account. New subscribers can no longer be added to the deleted plan, while existing subscribers remain unaffected.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
planstringrequired
The unique identifier of the plan to delete. Must be no longer than 5000 characters.

2 status codes
200Returns a deleted plan object containing its identifier, object type, and `deleted: true`.
deletedbooleanrequired
Always true for a deleted object
Allowed:true
idstringrequired
Unique identifier for the object.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:plan
defaultReturns an error object containing an error type and details about the failed request.
errorobjectrequired

Error handling

plan must identify the plan to delete and must be a string no longer than 5000 characters. Use the plan identifier returned when the plan was created or listed.