Skip to main content
DELETE
/
api
/
partner
/
v2
/
banks
/
receivers
/
{receiverId}
/
accounts
/
{userBankInfoId}
cURL
curl --request DELETE \
  --url https://staging-api.capa.fi/api/partner/v2/banks/receivers/{receiverId}/accounts/{userBankInfoId} \
  --header 'partner-api-key: <partner-api-key>'
Deletes a bank account for a user by receiver ID. Resolves the user from the receiver, then performs a soft delete.

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
User Ownership Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”Partner information is required for this operation”
401UNAUTHORIZED”User is not associated with the partner”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input”
403USER_BANK_INFO_ACCESS_DENIED”The bank information does not belong to the specified user.”
404RECEIVER_NOT_FOUND”Receiver not found.”
404USER_BANK_INFO_NOT_FOUND”User bank information not found.”

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Path Parameters

​
receiverId
string
required

The receiver ID

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

​
userBankInfoId
string
required

The user bank info ID to delete

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

Response

200

Deletes a bank account for a user by receiverId and userBankInfoId. First gets the user by receiver ID, then performs a soft delete.