Update Related Party Status
Introduction
This resource activates or deactivates a related party within a registration analysis.
A party submitted by mistake, or that is no longer part of the ownership structure, is deactivated here. Parties with the inactive status are ignored in every validation of the submission for analysis — they do not count toward the minimum quantity requirement, do not count toward the legal representative requirement, do not add up ownership percentage and do not have documents required.
- Partner submitted by mistake → deactivate with
inactive - Ownership structure changed → deactivate those who left and create those who joined
- Ownership percentage above 100% (
IVR000169) → deactivate the duplicate party, or correct the percentage with Update Related Party
Input / Output:
As input, the new status must be sent.
As output, the confirmation of the change is returned.
Request
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/related_party/{external_related_party_key}/statusPUT202Request body
{
"status": "inactive"
}
Body params
| Field | Type | Description | Required |
|---|---|---|---|
status | string | Related Party Status enumerator | Yes |
Related Party Status
| Enumerator | Description |
|---|---|
active | Party taken into account in every validation of the submission for analysis |
inactive | Party disregarded in every validation. Equivalent to removing the party from the registration |
The change is rejected with IVR000185 when the registration analysis is already in one of the final statuses: automatically_approved, automatically_reproved, manually_approved, manually_reproved, analysis_complete or expired.
An external_related_party_key unknown to the analysis provided is rejected with IVR000183.