Create a TaxBit Account Owner

post

https://api.multi1.enterprise.taxbit.com/v1/account-owners

Create an Account Owner to link with accounts in TaxBit's system. By default, you can use this API at 50 requests per second (RPS). If your use case requires a higher RPS, please contact your Implementation Manager.

Body Params

string

required

Your system's unique identifier for the Account Owner.

account_owner_type

enum

required

The type of Account Owner.

Allowed:

us_tax_classification

enum

US federal tax classification of the account owner. This field should only be provided when the account owner does not have a residence in the United States but does have a valid US TIN.

fatca_classification

enum

The Account Owner's classification under FATCA regulations. Required for certain non-U.S. entities to determine reporting obligations.

name

string

Account Owner's full name.

string

Account Owner's email address.

phone

string

Account Owner's phone number.

birth_date

date

ISO-8601 date when the Account Owner was born.

tax_residencies

array of objects

A list of the Account Owner's tax residencies.

tax_residencies

tin

string

deprecated

Account's Owner's TIN.

tin_type

enum

deprecated

The type of TIN

Allowed:

tax_country_code

string

deprecated

Country the Account Owner is subject to taxes。

us_tin

string

The US Taxpayer Identification Number (TIN) associated with the account owner. This field should only be provided when the account owner does not have a residence in the United States but does have a valid US TIN.

us_tin_type

enum

Indicates the type of US TIN provided. This field should only be provided when the account owner does not have a residence in the United States but does have have a valid US TIN.

address

object

mailing_address

object

prefers_physical_mail

boolean

Whether the Account Owner's tax forms will be sent through physical mail instead of electronically. Defaults to false.

is_tax_exempt

boolean

account

object

birth_city

string

The name of the city where the Account Owner was born.

birth_country

string

The name of the country where the Account Owner was born.

vat_country_code

string

The country code associated with the Account Owner's VAT identification number, indicating the country where the VAT is registered.

vat_id

string

The identification number assigned to the Account Owner's business for Value Added Tax (VAT) purposes by the relevant tax authority.

business_registration_country_code

string

Country code representing the location where the Account Owner's business is officially registered.

business_registration_number

string

The official registration number assigned to the Account Owner's business by the country where it is registered.

financial_account_id

string

A unique identifier assigned to the Account Owner's financial account.

financial_account_holder_name

string

The name of the individual or entity that holds the financial account associated with the Account Owner.

giin

string

Global Intermediary Identification Number

Responses

201Account Owner Successfully Created。

400Bad Request

403Forbidden

409Conflict.

429Too Many Requests - Throttling.