> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete account

> Hard-delete an account under your organization

`DELETE /api/v2/accounts/{customerId}`

Hard-deletes an account under your organization. Only `CHILD`-type accounts can be deleted, and the caller must be an `ADMIN` on the organization (or a Scope3 SuperAdmin). The request is refused if the account still has linked resources.

## Request

```bash curl theme={null}
curl -X DELETE https://api.interchange.io/api/v2/accounts/205 \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field        | In   | Type   | Required | Notes                       |
| ------------ | ---- | ------ | -------- | --------------------------- |
| `customerId` | path | string | Yes      | ID of the account to delete |

## Response

`204 No Content` — the account was deleted. The response body is empty.

## Errors

* `401 UNAUTHORIZED` — missing or invalid bearer token.
* `403 FORBIDDEN` — caller is not an `ADMIN` on the organization.
* `404 NOT_FOUND` — the account does not exist or is not under the caller's organization.
* `409 CONFLICT` — the account still has linked resources and cannot be deleted.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Account tasks" href="/v2/buyer/account/tasks" icon="list-check">
    All account operations
  </Card>

  <Card title="Create account" href="/v2/buyer/account/tasks/create-child-account" icon="plus">
    Add an account under your organization
  </Card>

  <Card title="List accounts" href="/v2/buyer/account/tasks/list-customer-accounts" icon="list">
    Accounts you can access
  </Card>
</CardGroup>