Set Main Bank Account
Introduction
This resource sets (or removes) a bank account as the investor's main account within a registration analysis. Only one account can be marked as main at a time — when an account is marked as main, the previously main account is automatically unmarked.
Available on
| Profile | Host |
|---|---|
| Distributor | distributor-api |
Base URL for each host: Environments (Hosts).
Request
ENDPOINT
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/bank_account/{external_bank_account_key}/defaultMETHOD
PUTSTATUS
202Request body
Request Body
{
"value": true
}
Body params
| Field | Type | Description | Required |
|---|---|---|---|
value | boolean | true to set this account as main | 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 | IVR000193 | An inactive account cannot be the main account |
Authentication, permission and host errors: see API Errors.