Sample - Stripe API
DELETE/v1/accounts/{account}

Delete a connected account

Deletes a connected account managed by the authenticated user's platform. Test-mode accounts can be deleted at any time, while eligible live-mode accounts must have zero balances before deletion.

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

1 parameter
accountstringrequired
Unique identifier of the connected account to delete; the value must be no longer than 5000 characters.

2 status codes
200Returns a deleted-account object containing the account identifier, the account object type, and `deleted` set to 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:account
defaultError response.
errorobjectrequired

Error handling

account must be a string no longer than 5000 characters and must identify an account managed by the platform. Live-mode accounts must satisfy the deletion conditions for their dashboard access and balance state before deletion.