Submit W-8BEN Tax Documentation Data

post

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

Submit W-8BEN tax documentation data for an account owner. This endpoint allows you to collect and store W-8BEN form information required for tax reporting and compliance.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Your system's unique identifier for the Account Owner

Body Params

name

string

The legal name of the account owner

country

string

enum

ISO 3166-1 alpha-2 country code

permanent_address

object

The account owner's permanent residence address, used to determine their country of tax residency for W-8BEN purposes. This should reflect where the individual physically resides and is not a P.O. box or in-care-of address.

mailing_address

object

An optional mailing address for the account owner, used if correspondence should be sent to a location different from their permanent residence address.

us_tin

string

The taxpayer's US tax identification number

ftin

string

The taxpayer's foreign tax identification number

date_of_birth

date

Date of birth (MM/DD/YYYY format)

reference_numbers

string

Reference number(s) if any

ftin_not_legally_required

boolean

Defaults to false

Indicates whether the foreign tax identification number is not legally required. If true, a ftin should not be provided.

has_signed_and_certified

boolean

Indicates whether the form has been signed and certified by the account owner

signature_timestamp

date-time

The timestamp when the form was signed (ISO 8601 format)

completed_for

string

enum

Defaults to ACCOUNT_HOLDER

Indicates for whom the tax documentation form is completed

Allowed:

treaty_claim_is_eligible

boolean

Indicates whether the account owner is eligible to claim treaty benefits

treaty_claim_country

string

enum

The country for which the account owner is claiming treaty benefits on the W-8BEN form. This must be a country that maintains an active income tax treaty with the United States and with which the individual has a valid tax residency tie.

treaty_claim_i_certify_resident

boolean

Certifies that the account owner is a resident of the country where they are claiming treaty benefits

treaty_claim_type_of_income

string

enum

The type of income being claimed for treaty benefits

Allowed:

treaty_claim_rate_of_withholding

string

The rate of withholding on the type of income

treaty_claim_article_paragraph

string

The article and paragraph of the tax treaty

treaty_claim_has_additional_conditions

boolean

Indicates whether there are additional conditions under the treaty

Responses

201W-8BEN submission created successfully

400Bad Request - Invalid input data

401Unauthorized Error.

403Forbidden

404Not Found - Account Owner with the specified ID does not exist

429Too Many Requests - Throttling.