Account Owners

Account Owners can be added and removed through our Account Owner APIs.

Account owner - APIs

Add owners.
Remove owners.

Add owners

POST /accounts/1041000017/owners/add

Request Body

{
                        "holders": [
                        {
                            "customerId": "c88f8b08-4669-4e24-a200-0f71e07b0a98"
                        },
                        {
                            "customerId": "0a4ed46e-9b36-457a-802e-d0ac25dc7aa3"
                        }
                        ]
                    }

Response

{
                        "holders": [
                        {
                            "customerId": "c88f8b08-4669-4e24-a200-0f71e07b0a98",
                            "name": {
                            "first": "MANUEL",
                            "middle": "ANTONIO",
                            "last": "PETERSON"
                            },
                            "taxId": "*****6532",
                            "taxIdCountry": "US",
                            "governmentId": "GOVERNMENT-ID1",
                            "contact": {
                            "email": [
                                "mapeterson@domain.com"
                            ],
                            "telephones": [
                                {
                                "type": "HOME",
                                "country": "US",
                                "number": "(555) 555-1234"
                                }
                            ]
                            },
                            "ownerStatus": "Added"
                        },
                        {
                            "customerId": "0a4ed46e-9b36-457a-802e-d0ac25dc7aa3",
                            "ownerStatus": "Failed to Add"
                        }
                        ]
                    }

Remove owners

POST /accounts/1041000017/owners/remove

Request Body

{
                        "holders": [
                        {
                            "customerId": "c88f8b08-4669-4e24-a200-0f71e07b0a98"
                        },
                        {
                            "customerId": "132352a9-1619-43dd-81cf-fa3e88089e60"
                        }
                        ]
                    }

Response

{
                        "holders": [
                        {
                            "customerId": "c88f8b08-4669-4e24-a200-0f71e07b0a98",
                            "ownerStatus": "Removed"
                        },
                        {
                            "customerId": "132352a9-1619-43dd-81cf-fa3e88089e60",
                            "ownerStatus": "Not found"
                        }
                        ]
                    }