Submit Tax Documentation Data

post

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

Submits complete and clean W-9, W-8BEN, or W-8BEN-E data for an Account Owner. Each submission is immutable.

Path Params

string

required

Your system's unique identifier for the Account Owner

Body Params

document_type

string

enum

required

The document type of the collected tax documentation data

Allowed:

name

string

required

The legal name of the beneficial owner of the account

dba_name

string

The "doing business as" (DBA) or "disregarded entity" (DRE) name

tax_classification

string

enum

required

The federal tax classification of name; if tax_classification != OTHER, other_tax_classification must be empty

other_tax_classification

string

The tax classification not listed; if tax_classification = OTHER, this field is required

exempt_payee_code

string

enum

The code used to identify payees who are exempt from backup withholding

exempt_fatca_code

string

enum

The code used to identify payees who are exempt from FATCA reporting

address

object

required

The address of name

tin

string

required

The U.S. tax identification number (TIN) associated with the name; the TIN must consist of 9 numerical digits, must not be sequential or repeating, must not begin with five zeros, and must not contain any alphabetic characters

tin_type

string

enum

required

The type of US tax identification number; if tax_classification = INDIVIDUAL, tin_type must be SSN, ITIN, or ATIN - else, tin_type must be EIN

Allowed:

has_certified

boolean

enum

required

The user has certified under penalties of perjury all necessary certifications

Allowed:

is_not_subject_backup_withholding

boolean

required

The user has certified that they are not subject to backup withholding

signature

string

required

The signed name of signor (i.e., individual authorized to sign for name); if tax_classification = INDIVIDUAL, signature must equal name

signature_timestamp

string

required

The date and time when the form was signed; the timestamp must be within 24 hours of the current UTC time

Responses

401

Forbidden

403

Wrong Account Owner

404

Tax Documentation Not Found

200Tax Documentation Data

400Invalid Data

429Too Many Requests - Throttling.