Deel: Create a tax form for the authenticated worker — request body — body data fatca status: ACTIVE NFFE, PASSIVE NFFE, form type: W8 BEN E tax treaty benefits form Tax treaty benefits details

API reference · Contract 2026-10-27

SDK schema: Create a tax form for the authenticated worker — request body — body / data / fatca_status: ACTIVE NFFE, PASSIVE NFFE, form type: W8 BEN E tax treaty benefits form Tax treaty benefits details

Field	Type	Presence	Description and constraints
$	object	Root	Tax treaty benefits details.
article_and_paragraph	string	Optional	Article and paragraph of the applicable tax treaty. Maximum length: 100
details	string	Optional	Additional details about the treaty claim. Maximum length: 400
is_tax_residency_certified	boolean or null	Optional	Whether tax residency is certified. Default: false
limitation_type	JSON	Optional	Limitation on benefits (LOB) type.
limitation_type (oneOf 1)	string	Alternative	Limitation on benefits (LOB) type. One of: GOVERNMENT, PENSION_TRUST, TAX_EXEMPT, PUBLICLY_TRADED_CORPORATION, SUBSIDIARY, OWNERSHIP_TEST, DERIVATIVE_TEST, ACTIVE_TRADE_TEST, FAVORABLE, NO_ARTICLE, OTHER
limitation_type (oneOf 2)	null	Alternative
other_article_and_paragraph	string or null	Optional	Other article and paragraph. Required when limitation_type is ‘OTHER’. Maximum length: 50
owner_resident_country	string	Optional	Country of residence of the beneficial owner. Maximum length: 2 Minimum length: 2 Pattern: ^[A-Z]{2}$
type_of_income	string	Optional	Type of income covered by the treaty. Maximum length: 25
withholding_rate	number	Optional	Withholding rate under the treaty (percentage). Format: double Maximum: 100 Minimum: 0