Update Bank Account Status
Introduction
This resource changes the status of a bank account previously registered in a registration analysis — for example, to deactivate an account that should no longer be used.
The account is identified by its external key (external_bank_account_key), returned on creation.
Request
ENDPOINT
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/bank_account/{external_bank_account_key}/statusMETHOD
PUTSTATUS
202Request body
Request Body
{
"status": "inactive"
}
Body params
| Field | Type | Description | Required |
|---|---|---|---|
status | string | New status of the account. Typical values: active, inactive | Yes |
Response
202 Accepted. The updated representation of the account is returned in the body.
Errors
| Status | Code | When it happens |
|---|---|---|
| 400 | IVR000185 | The analysis has already been closed (approved, rejected, completed or canceled) |
| 404 | IVR000181 | Account not found for the external_bank_account_key |
| 400 | IVR000075 | Invalid status value |
| 400 | IVR000074 | The main account cannot be deactivated |
Authentication, permission and host errors: see API Errors.