Skip to main content
DELETE /api/v2/accounts/{customerId} Permanently deletes an account under your organization. Only CHILD-type accounts can be deleted, and the caller must be an ADMIN on the organization. The call refuses with 409 if the account still has linked resources — unwind those first.

​
Request

curl
curl -X DELETE https://api.interchange.io/api/v2/accounts/200 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

FieldTypeRequiredNotes
customerIdstringYesPath parameter. ID of the account to delete

​
Response

204 No Content. The account is removed; there is no response body.

​
Errors

  • 401 UNAUTHORIZED — caller is not an ADMIN on the organization.
  • 409 CONFLICT — the account still has linked resources.
See Errors for the full error contract.

Account tasks

All account operations

Create account

Provision a new account

List accounts

Find the account ID