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

# Delete Bank Account

> Delete the existing bank account

[Suggest Edits](/edit/delete-bank-account)

To delete a bank account, this API requires two path parameters:

* **aggregator\_type:** Specifies the source type of the account’s aggregator.
* **account\_uuid:** The unique identifier associated with the subscribed bank account.

These parameters ensure the correct account is identified and processed.

<Info>
  This route is secured with **processor** and **vendor** token authentication.
</Info>

***

### Endpoint

DELETE   **/3p/api/v2/bank-accounts/\{aggregator\_type}/\{account\_uuid}**

### Path Parameter

| Fields               | Type   | Is Required | Description                                |
| -------------------- | ------ | ----------- | ------------------------------------------ |
| **aggregator\_type** | string | Yes         | *Possible values: bank\_link manual plaid* |
| **account\_uuid**    | string |             | The bank account uuid                      |

### Response Object

<CodeGroup>
  ```json Success (200) theme={"system"}
  {
      "status": true,
      "message": "The bank account has been deleted.",
      "data": [],
      "errors": []
  }
  ```
</CodeGroup>

### Errors & Warnings

<CodeGroup>
  ```json 400 (Bad request) theme={"system"}
  {
      "status": false,
      "message": "Invalid value provided for Accept header.",
      "data": null,
      "errors": null,
      "error_code": {
          "type": "client_error",
          "subtype": "missing_accept_header"
      }
  }
  ```

  ```json 401 (Unauthorized) theme={"system"}
  {
      "status": false,
      "message": "Invalid token.",
      "data": null,
      "errors": null,
      "error_code": {
          "type": "client_error",
          "subtype": "unauthorized"
      }
  }

  -----------------------------------------------------

  {
      "status": false,
      "message": "Invalid token format. The token should be in the following format: ID|TOKEN_VALUE. Example: 12345|abcdefg",
      "data": null,
      "errors": null,
      "error_code": {
          "type": "client_error",
          "subtype": "invalid_token_format"
      }
  }

  -----------------------------------------------------

  {
      "status": false,
      "message": "Invalid token format. The ID in the token must be an integer. Example: 12345|abcdefg",
      "data": null,
      "errors": null,
      "error_code": {
          "type": "client_error",
          "subtype": "invalid_token_format"
      }
  }
  ```

  ```json 403 (Forbidden) theme={"system"}
  {
      "status": false,
      "message": "Deletion is not possible while transactions are in progress.",
      "data": null,
      "errors": null,
      "error_code": null
  }
  ```

  ```json 404 (Not Found) theme={"system"}
  {
      "status": false,
      "message": "No bank account found with given details.",
      "data": null,
      "errors": null,
      "error_code": {
          "type": "client_error",
          "subtype": "uuid_not_found"
      }
  }

  -----------------------------------------------------

  {
      "status": false,
      "message": "The route 3p/api/v2/bank-accounts/bank_link could not be found.",
      "data": null,
      "errors": null,
      "error_code": null
  }
  ```
</CodeGroup>