Update an Existing TaxBit Account Owner

patch

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

Update an existing Account Owner in TaxBit's system.

Path Params

string

required

Your system's unique identifier for the Account Owner

Body Params

account_owner_type

enum

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 | null

A list of the Account Owner's tax residencies. Set to null to clear all existing tax residencies.

tax_residencies

tin

string

deprecated

Account 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

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

200Account Owner Successfully Updated

400Bad Request

403Forbidden

404Not Found

429Too Many Requests - Throttling.