v1

latestOpenAPI 3.0.1Apache 2.02026-07-248286406.8 KB
Tax

Submit W-8ECI tax form

This POST endpoint is used to submit a W-8ECI tax form (for foreign persons claiming income effectively connected with US trade or business) 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/w8eci

Request body

trade_namestring

Trade name (DBA)

organization_countrystring required

Two-letter country code of organization

entity_type'PARTNERSHIP' | 'FOREIGN GOVT-CONTROLLED ENTITY' | 'FOREIGN GOVT-INTERGRAL PART' | 'PRIVATE FOUNDATION' | 'SIMPLE TRUST' | 'GRANTOR TRUST' | 'INTERNATIONAL ORGANIZATION' | 'INDIVIDUAL' | 'COMPLEX TRUST' | 'CENTRAL BANK OF ISSUE' | 'CORPORATION' | 'ESTATE' | 'TAX-EXEMPT ORGANIZATION' required

Type of entity

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

Type of US TIN

tinstring required

US Taxpayer Identification Number

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

item_of_incomestring required

Description of income items effectively connected with US trade/business

is_dealer_securities_or_ptpboolean

Is dealer in securities or transferor of PTP interest

signature_namestring required

Name of the person signing the form

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