v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB

Tax

Submit W-8BEN tax form

This POST endpoint is used to submit a W-8BEN tax form (for foreign individuals) 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/w8ben

Request body

citizen_of_countrystring required

Two-letter country code of citizenship

us_tin_type'SSN' | 'ITIN'

Type of US TIN (if applicable)

us_tinstring

US Taxpayer Identification Number (if applicable)

foreign_tinstring

Foreign Tax Identification Number

is_ftin_not_legally_requiredboolean

Check if FTIN is not legally required

reference_numberstring

Reference number for your records

signature_namestring required

Name of the person signing the form

Response

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