Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB
Tax

Submit W-9 tax form

This POST endpoint is used to submit a W-9 tax form for a specific user identified by their user_token. Basic information (name, address, phone) is retrieved from the user's existing profile.

post/payout/{user_token}/tax/interview/w9

Request body

tin_type'SSN' | 'EIN' | 'ITIN' required

Type of Taxpayer Identification Number

tinstring required

Taxpayer Identification Number (format: XXX-XX-XXXX for SSN/ITIN or XX-XXXXXXX for EIN)

federal_tax_classification'Individual' | 'Sole Proprietor' | 'Single Member LLC Not Elected' | 'Single Member LLC Elected' | 'C Corporation' | 'S Corporation' | 'Partnership' | 'Trust or Estate' | 'LLC C Corporation' | 'LLC S Corporation' | 'LLC Partnership' | 'Others' required

Federal tax classification of the person

business_namestring

Business name/disregarded entity name, if different from name on file

is_backup_withholdingboolean

Whether the person is subject to backup withholding

exempt_payee_code'1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13'

Exempt payee code (if applicable)

exempt_fatca_code'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M'

Exemption from FATCA reporting code (if applicable)

account_numbersstring

Account number(s) for reference

is_line_3bboolean

Check if partnership/trust/estate with foreign partners/owners/beneficiaries

other_descriptionstring

Description when 'Others' is selected as federal tax classification

Response

OK

submission_idstring uuid

Unique identifier for the submission

form_type'W9' | 'W8BEN' | 'W8BENE' | 'W8ECI' | 'W8IMY'

Type of form submitted

status'Submitted' | 'Pending' | 'Validated' | 'Error'

Current status of the submission

submitted_atstring date-time

Timestamp of submission

pdf_contentstring

Base64 encoded byte representing the content of the file