Deel: List tax forms for the authenticated worker — 200 response body — data item

API reference · Contract 2026-10-27

SDK schema: List tax forms for the authenticated worker — 200 response body — data item

Field	Type	Presence	Description and constraints
$	JSON	Root	discriminator: {“propertyName”: “form_type”}
$ (anyOf 1)	object	Alternative	W9_INDIVIDUAL variant
$ (anyOf 1).address	string	Optional	Street address of permanent residence.
$ (anyOf 1).business_name	JSON	Optional
$ (anyOf 1).business_name (anyOf 1)	string	Alternative	Business name. Present on W9_COMPANY forms and disregarded-entity W9_INDIVIDUAL forms.
$ (anyOf 1).business_name (anyOf 2)	null	Alternative	Business name. Present on W9_COMPANY forms and disregarded-entity W9_INDIVIDUAL forms.
$ (anyOf 1).city	JSON	Optional
$ (anyOf 1).city (anyOf 1)	string	Alternative	City name.
$ (anyOf 1).city (anyOf 2)	null	Alternative	City name.
$ (anyOf 1).client_legal_entity_id	string	Required within parent	Public ID of the client’s legal entity the form was submitted against. Format: uuid
$ (anyOf 1).contractor_signature	string	Optional	The signer’s digital signature.
$ (anyOf 1).country	string	Optional	ISO 3166-1 alpha-2 country code of permanent residence.
$ (anyOf 1).created_at	string	Required within parent	Timestamp of when the tax form was created. Format: date-time
$ (anyOf 1).first_name	string	Optional	Legal first name. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 1).form_type	string	Required within parent	Discriminator value: W9_INDIVIDUAL Known values: W9_INDIVIDUAL
$ (anyOf 1).id	string	Required within parent	The public ID (UUID) of the tax form. Format: uuid
$ (anyOf 1).is_disregarded_entity	boolean	Optional	Whether this is a disregarded entity. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 1).is_subject_backup_withholding	boolean	Optional	Whether the contractor is subject to backup withholding. Present on W-9 forms.
$ (anyOf 1).last_name	string	Optional	Legal last name. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 1).middle_name	string	Optional	Legal middle name. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 1).pdf_url	JSON	Optional
$ (anyOf 1).pdf_url (anyOf 1)	string	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 1).pdf_url (anyOf 2)	null	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 1).state	JSON	Optional
$ (anyOf 1).state (anyOf 1)	string	Alternative	State or province code.
$ (anyOf 1).state (anyOf 2)	null	Alternative	State or province code.
$ (anyOf 1).tax_number	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W9 COMPANY tax number Taxpayer identification number. Returned unmasked.
$ (anyOf 1).updated_at	string	Required within parent	Timestamp of when the tax form was last updated. Format: date-time
$ (anyOf 1).zip_code	string	Optional	ZIP/postal code.
$ (anyOf 2)	object	Alternative	W9_COMPANY variant
$ (anyOf 2).address	string	Optional	Street address of permanent residence.
$ (anyOf 2).business_name	JSON	Optional
$ (anyOf 2).business_name (anyOf 1)	string	Alternative	Business name. Present on W9_COMPANY forms and disregarded-entity W9_INDIVIDUAL forms.
$ (anyOf 2).business_name (anyOf 2)	null	Alternative	Business name. Present on W9_COMPANY forms and disregarded-entity W9_INDIVIDUAL forms.
$ (anyOf 2).city	JSON	Optional
$ (anyOf 2).city (anyOf 1)	string	Alternative	City name.
$ (anyOf 2).city (anyOf 2)	null	Alternative	City name.
$ (anyOf 2).client_legal_entity_id	string	Required within parent	Public ID of the client’s legal entity the form was submitted against. Format: uuid
$ (anyOf 2).contractor_signature	string	Optional	The signer’s digital signature.
$ (anyOf 2).country	string	Optional	ISO 3166-1 alpha-2 country code of permanent residence.
$ (anyOf 2).created_at	string	Required within parent	Timestamp of when the tax form was created. Format: date-time
$ (anyOf 2).doing_business_as	JSON	Optional
$ (anyOf 2).doing_business_as (anyOf 1)	string	Alternative	DBA name. Present on W9_COMPANY forms.
$ (anyOf 2).doing_business_as (anyOf 2)	null	Alternative	DBA name. Present on W9_COMPANY forms.
$ (anyOf 2).federal_tax_classification	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W9 COMPANY federal tax classification Federal tax classification. Present on W9_COMPANY forms.
$ (anyOf 2).form_type	string	Required within parent	Discriminator value: W9_COMPANY Known values: W9_COMPANY
$ (anyOf 2).id	string	Required within parent	The public ID (UUID) of the tax form. Format: uuid
$ (anyOf 2).is_subject_backup_withholding	boolean	Optional	Whether the contractor is subject to backup withholding. Present on W-9 forms.
$ (anyOf 2).pdf_url	JSON	Optional
$ (anyOf 2).pdf_url (anyOf 1)	string	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 2).pdf_url (anyOf 2)	null	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 2).state	JSON	Optional
$ (anyOf 2).state (anyOf 1)	string	Alternative	State or province code.
$ (anyOf 2).state (anyOf 2)	null	Alternative	State or province code.
$ (anyOf 2).tax_number	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W9 COMPANY tax number Taxpayer identification number. Returned unmasked.
$ (anyOf 2).updated_at	string	Required within parent	Timestamp of when the tax form was last updated. Format: date-time
$ (anyOf 2).zip_code	string	Optional	ZIP/postal code.
$ (anyOf 3)	object	Alternative	W8_BEN variant
$ (anyOf 3).address	string	Optional	Street address of permanent residence.
$ (anyOf 3).address_line2	JSON	Optional
$ (anyOf 3).address_line2 (anyOf 1)	string	Alternative	Street address line 2. Present on W8_BEN and W8_BEN_E forms.
$ (anyOf 3).address_line2 (anyOf 2)	null	Alternative	Street address line 2. Present on W8_BEN and W8_BEN_E forms.
$ (anyOf 3).city	JSON	Optional
$ (anyOf 3).city (anyOf 1)	string	Alternative	City name.
$ (anyOf 3).city (anyOf 2)	null	Alternative	City name.
$ (anyOf 3).client_legal_entity_id	string	Required within parent	Public ID of the client’s legal entity the form was submitted against. Format: uuid
$ (anyOf 3).contractor_signature	string	Optional	The signer’s digital signature.
$ (anyOf 3).country	string	Optional	ISO 3166-1 alpha-2 country code of permanent residence.
$ (anyOf 3).country_of_citizenship	string	Optional	ISO 3166-1 alpha-2 country code of citizenship (W8_BEN) or incorporation (W8_BEN_E).
$ (anyOf 3).created_at	string	Required within parent	Timestamp of when the tax form was created. Format: date-time
$ (anyOf 3).date_of_birth	JSON	Optional
$ (anyOf 3).date_of_birth (anyOf 1)	string	Alternative	Date of birth. Present on W8_BEN and W8_BEN_E forms. Format: date-time
$ (anyOf 3).date_of_birth (anyOf 2)	null	Alternative	Date of birth. Present on W8_BEN and W8_BEN_E forms. Format: date-time
$ (anyOf 3).first_name	string	Optional	Legal first name. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 3).form_type	string	Required within parent	Discriminator value: W8_BEN Known values: W8_BEN
$ (anyOf 3).id	string	Required within parent	The public ID (UUID) of the tax form. Format: uuid
$ (anyOf 3).is_certified_and_agreed	JSON	Optional
$ (anyOf 3).is_certified_and_agreed (anyOf 1)	boolean	Alternative	Certification that the signer has read and agrees with the certification information. Present on W8_BEN forms.
$ (anyOf 3).is_certified_and_agreed (anyOf 2)	null	Alternative	Certification that the signer has read and agrees with the certification information. Present on W8_BEN forms.
$ (anyOf 3).is_disregarded_entity	boolean	Optional	Whether this is a disregarded entity. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 3).is_ftin_not_legally_required	boolean	Optional	Whether an FTIN is not legally required in the country of residence. Present on W-8 forms.
$ (anyOf 3).is_tax_treaty_enabled	JSON	Optional
$ (anyOf 3).is_tax_treaty_enabled (anyOf 1)	boolean	Alternative	Whether tax treaty benefits are claimed. Present on W-8 forms.
$ (anyOf 3).is_tax_treaty_enabled (anyOf 2)	null	Alternative	Whether tax treaty benefits are claimed. Present on W-8 forms.
$ (anyOf 3).last_name	string	Optional	Legal last name. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 3).mailing_address	JSON	Optional	Mailing address if different from permanent residence. Present on W8_BEN and W8_BEN_E forms.
$ (anyOf 3).mailing_address (anyOf 1)	Model	Alternative	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN mailing address address, address line2, city, country, state, zip code
$ (anyOf 3).mailing_address (anyOf 2)	null	Alternative
$ (anyOf 3).middle_name	string	Optional	Legal middle name. Present on W9_INDIVIDUAL and W8_BEN forms.
$ (anyOf 3).pdf_url	JSON	Optional
$ (anyOf 3).pdf_url (anyOf 1)	string	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 3).pdf_url (anyOf 2)	null	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 3).print_name_of_signer	JSON	Optional
$ (anyOf 3).print_name_of_signer (anyOf 1)	string	Alternative	Printed name of the signer. Present on W-8 forms.
$ (anyOf 3).print_name_of_signer (anyOf 2)	null	Alternative	Printed name of the signer. Present on W-8 forms.
$ (anyOf 3).referencing_information	JSON	Optional
$ (anyOf 3).referencing_information (anyOf 1)	string	Alternative	Reference number for the form. Present on W-8 forms.
$ (anyOf 3).referencing_information (anyOf 2)	null	Alternative	Reference number for the form. Present on W-8 forms.
$ (anyOf 3).state	JSON	Optional
$ (anyOf 3).state (anyOf 1)	string	Alternative	State or province code.
$ (anyOf 3).state (anyOf 2)	null	Alternative	State or province code.
$ (anyOf 3).tax_number	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN tax number Foreign taxpayer identification number. Returned unmasked.
$ (anyOf 3).tax_treaty_benefits_form	JSON	Optional	Tax treaty benefits details. Present when treaty benefits are claimed.
$ (anyOf 3).tax_treaty_benefits_form (anyOf 1)	Model	Alternative	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN tax treaty benefits form article and paragraph, details, owner resident country, type of income, withholding rate
$ (anyOf 3).tax_treaty_benefits_form (anyOf 2)	null	Alternative
$ (anyOf 3).updated_at	string	Required within parent	Timestamp of when the tax form was last updated. Format: date-time
$ (anyOf 3).us_tax_number	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN us tax number US Taxpayer Identification Number. Present on W8_BEN and W8_BEN_E forms. Returned unmasked.
$ (anyOf 3).zip_code	string	Optional	ZIP/postal code.
$ (anyOf 4)	object	Alternative	W8_BEN_E variant
$ (anyOf 4).address	string	Optional	Street address of permanent residence.
$ (anyOf 4).address_line2	JSON	Optional
$ (anyOf 4).address_line2 (anyOf 1)	string	Alternative	Street address line 2. Present on W8_BEN and W8_BEN_E forms.
$ (anyOf 4).address_line2 (anyOf 2)	null	Alternative	Street address line 2. Present on W8_BEN and W8_BEN_E forms.
$ (anyOf 4).city	JSON	Optional
$ (anyOf 4).city (anyOf 1)	string	Alternative	City name.
$ (anyOf 4).city (anyOf 2)	null	Alternative	City name.
$ (anyOf 4).client_legal_entity_id	string	Required within parent	Public ID of the client’s legal entity the form was submitted against. Format: uuid
$ (anyOf 4).contractor_signature	string	Optional	The signer’s digital signature.
$ (anyOf 4).country	string	Optional	ISO 3166-1 alpha-2 country code of permanent residence.
$ (anyOf 4).country_of_citizenship	string	Optional	ISO 3166-1 alpha-2 country code of citizenship (W8_BEN) or incorporation (W8_BEN_E).
$ (anyOf 4).created_at	string	Required within parent	Timestamp of when the tax form was created. Format: date-time
$ (anyOf 4).date_of_birth	JSON	Optional
$ (anyOf 4).date_of_birth (anyOf 1)	string	Alternative	Date of birth. Present on W8_BEN and W8_BEN_E forms. Format: date-time
$ (anyOf 4).date_of_birth (anyOf 2)	null	Alternative	Date of birth. Present on W8_BEN and W8_BEN_E forms. Format: date-time
$ (anyOf 4).entity_country	JSON	Optional
$ (anyOf 4).entity_country (anyOf 1)	string	Alternative	ISO 3166-1 alpha-2 country code of the entity. Present on W8_BEN_E forms.
$ (anyOf 4).entity_country (anyOf 2)	null	Alternative	ISO 3166-1 alpha-2 country code of the entity. Present on W8_BEN_E forms.
$ (anyOf 4).entity_type	string	Optional	Chapter 3 entity type. Present on W8_BEN_E forms. Known values: CORPORATION, DISREGARDED_ENTITY, PARTNERSHIP, SIMPLE_TRUST, GRANTOR_TRUST, COMPLEX_TRUST, ESTATE, GOVERNMENT, CENTRAL_BANK_OF_ISSUE, TAX_EXEMPT, PRIVATE_FOUNDATION, INTERNATIONAL, FOREIGN_GOVERNMENT_CONTROLLED, FOREIGN_GOVERNMENT_INTEGRAL
$ (anyOf 4).fatca_status	string	Optional	FATCA (Foreign Account Tax Compliance Act) status. Present on W8_BEN_E forms. Known values: ACTIVE_NFFE, PASSIVE_NFFE
$ (anyOf 4).form_type	string	Required within parent	Discriminator value: W8_BEN_E Known values: W8_BEN_E
$ (anyOf 4).giin	JSON	Optional
$ (anyOf 4).giin (anyOf 1)	string	Alternative	Global Intermediary Identification Number. Present on W8_BEN_E forms.
$ (anyOf 4).giin (anyOf 2)	null	Alternative	Global Intermediary Identification Number. Present on W8_BEN_E forms.
$ (anyOf 4).has_substantial_us_owner	boolean	Optional	Whether the entity has a substantial US owner. Present on W8_BEN_E forms.
$ (anyOf 4).id	string	Required within parent	The public ID (UUID) of the tax form. Format: uuid
$ (anyOf 4).is_entity_certification_confirmed	JSON	Optional
$ (anyOf 4).is_entity_certification_confirmed (anyOf 1)	boolean	Alternative	Certification that the entity is the beneficial owner of all income. Present on W8_BEN_E forms.
$ (anyOf 4).is_entity_certification_confirmed (anyOf 2)	null	Alternative	Certification that the entity is the beneficial owner of all income. Present on W8_BEN_E forms.
$ (anyOf 4).is_ftin_not_legally_required	boolean	Optional	Whether an FTIN is not legally required in the country of residence. Present on W-8 forms.
$ (anyOf 4).is_tax_treaty_enabled	JSON	Optional
$ (anyOf 4).is_tax_treaty_enabled (anyOf 1)	boolean	Alternative	Whether tax treaty benefits are claimed. Present on W-8 forms.
$ (anyOf 4).is_tax_treaty_enabled (anyOf 2)	null	Alternative	Whether tax treaty benefits are claimed. Present on W-8 forms.
$ (anyOf 4).mailing_address	JSON	Optional	Mailing address if different from permanent residence. Present on W8_BEN and W8_BEN_E forms.
$ (anyOf 4).mailing_address (anyOf 1)	Model	Alternative	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN mailing address address, address line2, city, country, state, zip code
$ (anyOf 4).mailing_address (anyOf 2)	null	Alternative
$ (anyOf 4).name_of_disregarded_entity	JSON	Optional
$ (anyOf 4).name_of_disregarded_entity (anyOf 1)	string	Alternative	Name of the disregarded entity, if applicable. Present on W8_BEN_E forms.
$ (anyOf 4).name_of_disregarded_entity (anyOf 2)	null	Alternative	Name of the disregarded entity, if applicable. Present on W8_BEN_E forms.
$ (anyOf 4).name_of_organization	string	Optional	Name of the organization. Present on W8_BEN_E forms.
$ (anyOf 4).pdf_url	JSON	Optional
$ (anyOf 4).pdf_url (anyOf 1)	string	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 4).pdf_url (anyOf 2)	null	Alternative	Pre-signed download URL for the generated form PDF. The link expires about 15 minutes after the response is issued — download promptly or request the list again. Null while the PDF has not been generated yet.
$ (anyOf 4).print_name_of_signer	JSON	Optional
$ (anyOf 4).print_name_of_signer (anyOf 1)	string	Alternative	Printed name of the signer. Present on W-8 forms.
$ (anyOf 4).print_name_of_signer (anyOf 2)	null	Alternative	Printed name of the signer. Present on W-8 forms.
$ (anyOf 4).referencing_information	JSON	Optional
$ (anyOf 4).referencing_information (anyOf 1)	string	Alternative	Reference number for the form. Present on W-8 forms.
$ (anyOf 4).referencing_information (anyOf 2)	null	Alternative	Reference number for the form. Present on W-8 forms.
$ (anyOf 4).state	JSON	Optional
$ (anyOf 4).state (anyOf 1)	string	Alternative	State or province code.
$ (anyOf 4).state (anyOf 2)	null	Alternative	State or province code.
$ (anyOf 4).tax_number	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN tax number Foreign taxpayer identification number. Returned unmasked.
$ (anyOf 4).tax_treaty_benefits_form	JSON	Optional	Tax treaty benefits details. Present when treaty benefits are claimed.
$ (anyOf 4).tax_treaty_benefits_form (anyOf 1)	Model	Alternative	Expand List tax forms for the authenticated worker — 200 response body — data / item / fatca_status: ACTIVE NFFE, PASSIVE NFFE, form type: W8 BEN E tax treaty benefits form article and paragraph, details, is tax residency certified, limitation type, other article and paragraph, owner resident country, type of income, withholding rate
$ (anyOf 4).tax_treaty_benefits_form (anyOf 2)	null	Alternative
$ (anyOf 4).updated_at	string	Required within parent	Timestamp of when the tax form was last updated. Format: date-time
$ (anyOf 4).us_tax_number	Model	Optional	Expand List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN us tax number US Taxpayer Identification Number. Present on W8_BEN and W8_BEN_E forms. Returned unmasked.
$ (anyOf 4).zip_code	string	Optional	ZIP/postal code.

Referenced models: List tax forms for the authenticated worker — 200 response body — data / item / form_type: W9 COMPANY tax number, List tax forms for the authenticated worker — 200 response body — data / item / form_type: W9 COMPANY federal tax classification, List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN mailing address address, address line2, city, country, state, zip code, List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN tax number, List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN tax treaty benefits form article and paragraph, details, owner resident country, type of income, withholding rate, List tax forms for the authenticated worker — 200 response body — data / item / form_type: W8 BEN us tax number, List tax forms for the authenticated worker — 200 response body — data / item / fatca_status: ACTIVE NFFE, PASSIVE NFFE, form type: W8 BEN E tax treaty benefits form article and paragraph, details, is tax residency certified, limitation type, other article and paragraph, owner resident country, type of income, withholding rate