API Reference

Submit W-8BEN-E tax form

post
https://{environment}.masspay.io/{VERSION}/payout//tax/interview/w8bene

This POST endpoint is used to submit a W-8BEN-E tax form for a specific user identified by their user_token. The W-8BEN-E form is used by foreign entities to certify their foreign status, chapter 3 status, chapter 4 (FATCA) status, and claim tax treaty benefits (if applicable). Basic information (name, address, phone) is retrieved from the user's existing profile.
To use this endpoint, you need to provide the user_token as a parameter in the URL Path and the W-8BEN-E form data in the request body.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
string
required
length ≤ 40

Name of the organization

string
required
length between 2 and 2

Two-letter country code of organization

string
length ≤ 80

Disregarded entity name (if applicable)

string
enum
required

Chapter 3 status for withholding

string
enum
required

Chapter 4 (FATCA) status

string
enum

Type of US TIN (if applicable)

Allowed:
string

US Taxpayer Identification Number (if applicable)

string
length ≤ 19

Global Intermediary Identification Number

string
length ≤ 25

Foreign Tax Identification Number

boolean
Defaults to false

Check if FTIN is not legally required

string
length ≤ 50

Reference number for your records

boolean
Defaults to false

Is entity a hybrid making a treaty claim

tax_treaty_benefits
object
string
enum

Limitation on benefits provision

substantial_us_owners
array of objects

List of substantial US owners (for passive NFFE)

substantial_us_owners
certification
object
required
Responses

404

Not Found

Updated about 1 month ago

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago