Create client account owner

post

https://wealth-rest-api.softwarealgo.com/v1/owner/create

Creates a new owner of a client account. Required fields may vary based on customer type and owner type value.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

ownerId

int64

Owner unique identifier generated by the system, required on edit

accountId

int64

required

Account numeric unique identifier

ownerType

string

required

Type of Ownership. Check /v1/systemcode/list API for valid values (type = 'Owner Type'), use the 'code' value.

firstName

string

required

Legal First Name of the owner

middleName

string

The surname of an individual's mother and the Middle Name of the owner

lastName

string

Legal last name of the owner

status

string

required

Check /v1/systemcode/list API for valid values (type = 'Status', subType = 'Owner Status'), use the 'code' value.

dateOfBirth

object

A full date, with non-zero year, month and day values
A month and day value, with a zero year, e.g. an anniversary
A year on its own, with zero month and day values
A year and month value, with a zero day, e.g. a credit card expiration date

Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and google.protobuf.Timestamp.

country

string

Check /v1/systemcode/list API for valid values (type = 'Country'), use the 'code' value.

employmentStatus

string

The status of an employee in a company on the basis of the contract of work or duration of work done. Check /v1/systemcode/list API for valid values (type = 'Employment Status', subType = 'Client Site'), use the 'code' value.

employmentOccupation

string

The profession or occupation of the account owner.

employmentName

string

Name of the Institution where the account holder was employed

ownership

boolean

An indicator if the account holder owns a stock company

stockOwnership

string

Stocks owned by the account holder

brokerMember

boolean

An indicator if the account holder is a broker member

brokerName

string

Name of the brokerage the account holder is affiliated to

affiliatePerson

string

The name of the broker that the account holder is affiliated to

affiliatePersonPosition

string

The position in the brokerage of the affiliated person

citizenship

string

The nationality of the account holder.

ofacStatus

string

OFAC listing status of the account holder ('Approved', 'Pending', 'Denied')

ofacDate

object

A full date, with non-zero year, month and day values
A month and day value, with a zero year, e.g. an anniversary
A year on its own, with zero month and day values
A year and month value, with a zero day, e.g. a credit card expiration date

Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and google.protobuf.Timestamp.

kycStatus

string

KYC, also called Know Your Customer, is a method of identifying and verifying customers of a bank or investors in stocks, mutual funds, and other investments.

kycDate

object

A full date, with non-zero year, month and day values
A month and day value, with a zero year, e.g. an anniversary
A year on its own, with zero month and day values
A year and month value, with a zero day, e.g. a credit card expiration date

Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and google.protobuf.Timestamp.

officer

boolean

If the owner is an officer to the account

owner

boolean

If this owner has ownership to the account

ownershipPercent

string

The numerical indicator of how much percent is the ownership of the account holder.

relationship

string

The relationship of the Owner to the Account Holder. Check /v1/systemcode/list API for valid values (type = 'Relationship', subType = 'Client Site'), use the 'code' value.

maritalStatus

string

The status of an individual in relation to marriage. Check /v1/systemcode/list API for valid values (type = 'Marital Status'), use the 'code' value.

natureOfBusiness

string

The type of business stated by the Account Owner

yearsEmployed

int32

The number of years the owner affiliated to the company

inactiveStatusReason

string

The reason why the record is inactive.

suffix

string

A word part added to the end of a word. Check /v1/systemcode/list API for valid values (type = 'Suffix'), use the 'code' value.

previousEmploymentName

string

The owner refers to the name of the business or investment entity where the owner was previously involved.

customerType

string

required

Natural Person or Legal Entity. Check /v1/systemcode/list API for valid values (type = 'Customer Type'), use the 'code' value.

dateOfDeath

object

A full date, with non-zero year, month and day values
A month and day value, with a zero year, e.g. an anniversary
A year on its own, with zero month and day values
A year and month value, with a zero day, e.g. a credit card expiration date

Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and google.protobuf.Timestamp.

traderId

string

The identification number assigned to the trader.

stockCompany

string

The name of the company where the Owner have stocks.

stockPosition

string

Position of the stock owned by the Owner

stockPerson

string

Related record for the Stock owned who is accountable for stocking merchandise in a retail space

addresses

array of objects

List of addresses associated with the owner. Used in account api only

addresses

contactInfos

array of objects

List of contact info associated with the owner. Used in account api only

contactInfos

identifications

array of objects

List of identification associated with the owner. Used in account api only

identifications

Response

200A successful response.