The Customer object

A person or a business the bank knows: identity, KYC status and risk rating. A customer must be KYC-verified before an account opens in their name.

Attributes

addressobjectRequired

6 child attributes

citystringRequired

countrystringRequired

line1stringRequired

line2stringOptional

postal_codestringRequired

statestringRequired

backup_withholdingbooleanRequired

24% is taken from interest while true (26 U.S.C. §3406)

backup_withholding_reasonstringOptional

created_atstring · date-timeRequired

date_of_birthstringRequired

deathobject or nullOptional

3 child attributes

date_of_deathstringRequired

report_idstringRequired

Example strp_2tVh8nqLxq4GbDe0K1F6S9zRcWm

revisionintegerRequired

emailstringRequired

idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

kyc_decided_atstring · date-time or nullOptional

kyc_statusstringRequired

legal_namestringRequired

phonestringRequired

risk_ratingstringRequired

statusstringRequired

tax_formstringOptional

W9, w8ben or w8bene on file

tax_form_expires_atstringOptional

W-8BEN: the last day of the third calendar year after it was signed

tax_form_received_atstringOptional

tax_id_last4stringRequired

tax_id_on_filebooleanRequired

A sealed tax id is stored

tax_status_recorded_atstring · date-time or nullOptional

Since this tax state was recorded; nil for legacy provenance.

tin_certifiedbooleanRequired

treaty_countrystringOptional

typestringRequired

updated_atstring · date-timeRequired