---
title: "Submit W-8BEN-E tax form"
method: POST
path: "/payout/{user_token}/tax/interview/w8bene"
tags: ["Tax"]
---

# Submit W-8BEN-E tax form

`POST /payout/{user_token}/tax/interview/w8bene`

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

## Request body

- W8BENEFormRequest
  - `organization_name` string, required — Name of the organization
  - `country_of_organization` string, required — Two-letter country code of organization
  - `disregarded_entity_name` string — Disregarded entity name (if applicable)
  - `chapter_3_status` 'SIMPLE TRUST' | 'CENTRAL BANK OF ISSUE' | 'GRANTOR TRUST' | 'TAX EXEMPT ORGANIZATION' | 'PRIVATE FOUNDATION' | 'DISREGARDED ENTITY' | 'CORPORATION' | 'COMPLEX TRUST' | 'ESTATE' | 'INTERNATIONAL ORGANIZATION' | 'PARTNERSHIP' | 'FOREIGN CONTROLLED ENTITY' | 'FOREIGN INTERGRAL PART', required — Chapter 3 status for withholding
  - `chapter_4_status` 'NONPARTICIPATING FFI' | 'PARTICIPATING FFI' | 'REPORTING MODEL1 FFI' | 'REPORTING MODEL2 FFI' | 'REGISTERED FFI' | 'SPONSORED FFI' | 'NONREGISTERING LOCALBANK' | 'FFI LOWVALUE ACCOUNT' | 'SPONSORED INVESTMENT VEHICLE' | 'LIMITED LIFEDEBT INVESTMENT' | 'NO FINANCIAL ACCOUNT' | 'OWNER DOCUMENTED FFI' | 'RESTRICTED DISTRIBUTOR' | 'NONREPORTING IGA FFI' | 'FOREIGN GOVERNMENT' | 'INTERNATIONAL ORGANIZATION' | 'EXEMPT RETIREMENT PLANS' | 'EXEMPT BENEFICIAL OWNERS' | 'TERRITORY FINANCIAL INSTITUTION' | 'EXCEPTED NONFINANCIAL GROUP' | 'EXCEPTED NONFINANCIAL STARTUP' | 'EXCEPTED NONFINANCIAL LIQUIDATION BANKRUPTCY' | '501C ORGANIZATION' | 'NONPROFIT ORGANIZATION' | 'PUBLICLY TRADED NFFE' | 'EXCEPTED TERRITORY NFFE' | 'ACTIVE NFFE' | 'PASSIVE NFFE' | 'EXCEPTED INTER AFFILIATE FFI' | 'DIRECT REPORTING NFFE' | 'SPONSORED DIRECT REPORTING FFI' | 'NON FINANCIAL ACCOUNT', required — Chapter 4 (FATCA) status
  - `us_tin_type` 'SSN' | 'ITIN' — Type of US TIN (if applicable)
  - `us_tin` string — US Taxpayer Identification Number (if applicable)
  - `giin` string — Global Intermediary Identification Number
  - `foreign_tin` string — Foreign Tax Identification Number
  - `is_ftin_not_legally_required` boolean — Check if FTIN is not legally required
  - `reference_number` string — Reference number for your records
  - `is_hybrid_entity_treaty_claim` boolean — Is entity a hybrid making a treaty claim
  - `tax_treaty_benefits` W8BENETaxTreatyBenefits
    - `is_claiming_treaty_benefits` boolean — Whether claiming treaty benefits
    - `beneficiary_country` string — Country claiming treaty benefits
    - `claiming_article_paragraph` string — Article and paragraph of the treaty
    - `rate_of_withholding` string — Rate of withholding (percentage)
    - `type_of_income` 'Paid by US Obligors—General' | 'Paid by US Corporations' | 'Qualifying for Direct Dividend Rate' | 'Pensions and Annuities' | 'Social Security' | 'Industrial Equipment' | 'Know-How/ Other Industrial Royalties' | 'Patents' | 'Film & TV' | 'Copyrights' | 'Others' — Type of income for treaty benefits
    - `additional_conditions` string — Additional conditions from the treaty
  - `limitation_on_benefits` 'GOVERNMENT' | 'TAX-EXEMPT PENSION TRUST OR PENSION FUND' | 'OTHER TAX-EXEMPT ORGANIZATION' | 'PUBLICLY TRADED CORPORATION' | 'SUBSIDIARY OF A PUBLICLY TRADED CORPORATION' | 'COMPANY THAT MEETS THE OWNERSHIP AND BASE EROSION TEST' | 'COMPANY THAT MEETS THE DERIVATIVE BENEFITS TEST' | 'COMPANY WITH AN ITEM OF INCOME THAT MEETS ACTIVE TRADE OR BUSINESS TEST' | 'FAVORABLE DISCRETIONARY DETERMINATION BY THE U.S. COMPETENT AUTHORITY RECEIVED' | 'NO LOB ARTICLE IN TREATY' | 'OTHER' — Limitation on benefits provision
  - `substantial_us_owners` SubstantialUSOwner[] — List of substantial US owners (for passive NFFE)
    - `name` string — Name of the substantial US owner
    - `address` string — Address of the substantial US owner
    - `tin_type` 'SSN' | 'EIN' — TIN type of the US owner
    - `tin` string — TIN of the US owner
  - `certification` W8Certification, required
    - `has_capacity_to_sign` boolean, required — Certifies capacity to sign for the entity
    - `signer_name` string, required — Name of the person signing

## Response `200`

OK

- TaxFormSubmissionResponse
  - `submission_id` string, 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_at` string, date-time — Timestamp of submission
  - `errors` TaxFormError[] — List of validation errors (if any)
    - `id` string — Error code
    - `name` string — Field name with the error
    - `message` string — Error description
  - `pdf_content` string — Base64 encoded byte representing the content of the file

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not Found
- `405` — Method Not Allowed.
- `500` — Internal server error.
- `504` — Gateway Time-out.

---

[API](https://skmtc.net/masspay/apis/masspay-api.md) · [All operations](https://skmtc.net/masspay/apis/masspay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/masspay/masspay-api/revisions/c03b61a6a551/schema)