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

# DELETE /v1/banks/:bankId — Permanently Delete Bank

> Permanently remove an in-game bank from the platform. Requires ADMINISTRATOR permission. Returns the bank object as it existed immediately before deletion.

Use this endpoint to permanently remove an in-game bank from the platform. This operation is irreversible — once a bank is deleted, the bank data cannot be recovered.

<Warning>
  Deleting a bank is permanent. Ensure you have confirmed this action with the relevant parties before proceeding. This endpoint requires the `ADMINISTRATOR` permission.
</Warning>

## Endpoint

```text theme={null}
DELETE https://api.cacolombia.com/v1/banks/:bankId
```

## Path Parameters

<ParamField path="bankId" type="string" required>
  The Snowflake ID of the bank you want to delete.
</ParamField>

## Response

A successful deletion returns HTTP `204 No Content` along with the bank object as it existed immediately before deletion.

<ResponseField name="bankId" type="string">
  The Snowflake ID of the deleted bank.
</ResponseField>

<ResponseField name="ownerId" type="string">
  The `characterId` of the character who owned the bank.
</ResponseField>

<ResponseField name="name" type="string">
  The display name of the bank at the time of deletion.
</ResponseField>

<ResponseField name="iconHash" type="string | null">
  The icon hash at the time of deletion, or `null` if none was set.
</ResponseField>

<ResponseField name="capital" type="number">
  The bank's capital balance at the time of deletion.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the bank was originally created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp of the last modification before deletion.
</ResponseField>

## Example Request

```bash theme={null}
curl -X DELETE "https://api.cacolombia.com/v1/banks/112233445566778800" \
  -H "Authorization: Bearer <your_token>"
```

## Example Response

```json theme={null}
{
  "bankId": "112233445566778800",
  "ownerId": "998877665544332211",
  "name": "Banco Nacional",
  "iconHash": null,
  "capital": 1000000,
  "createdAt": "2024-06-01T08:00:00.000Z",
  "updatedAt": "2024-06-05T12:30:00.000Z"
}
```

## Error Responses

| Status | Description                                                                       |
| ------ | --------------------------------------------------------------------------------- |
| `401`  | You are not authenticated. Provide a valid authorization token with your request. |
| `403`  | Your account does not hold the `ADMINISTRATOR` permission.                        |
| `404`  | No bank was found for the given `bankId`.                                         |

<Tip>
  Rate limiting applies to this endpoint. You can call it at most 5 times per minute per account.
</Tip>