---
title: "Delete one"
method: DELETE
path: "/v1/banking/bank_keys/{bank_key_id}"
tags: ["Bank key"]
---

# Delete one

`DELETE /v1/banking/bank_keys/{bank_key_id}`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/banking/bank_keys/{bank_key_id}`
- Auth: HTTP bearer

Deletes a bank key (banking credential) and detaches it from every company it
was associated with. The deleted key is returned in the response body.

Note: deletion can be blocked at the database level when the credential is
still referenced by other banking records (e.g. in-flight transactions). In
that case the request fails and the credential is preserved.

## Parameters

- `#/paths/~1v1~1banking~1bank_keys/get/parameters/0` (unresolved $ref)
- `#/paths/~1v1~1banking~1bank_keys~1%7Bbank_key_id%7D/get/parameters/1` (unresolved $ref)

## Response `200`

Deleted bank key

- Schema (unresolved $ref)

## Other responses

- `401`: Unauthorized
- `404`: Bank key not found

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) - [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/ff1aeb3fda8b?raw)