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 for non-U.S. individuals. An individual is a U.S. Person if they are a U.S. Citizen, U.S. Permanent Resident or have met the Substantial Presence Test. A business is a U.S. Person if they are organized or incorporated in the U.S.

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

Country identifier — an ISO 3166-1 alpha-2 code, or one of the supported IRS-only codes (for example FQ, WZ) or territory names (for example BURMA, SVALBARD) used where the IRS code collides with an ISO alpha-2 for a different country. See the enum for the full list.

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, in YYYY-MM-DD 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

deprecated

Indicates whether the account owner is eligible to claim treaty benefits. Deprecated: this is derived from the presence of treaty_claim_country and no longer needs to be sent.

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

signature

string

The name signed on the form. Requires has_signed_and_certified to be true. When omitted, Taxbit derives the signature from name for individuals and stores a placeholder for entities.

Responses

201W-8BEN submission created successfully

400Bad Request

401Unauthorized

403Forbidden

404Not Found

409Conflict

429Too Many Requests