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

# Submit W-8ECI tax form

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

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.

## Request body

- W8ECIFormRequest
  - `trade_name` string — Trade name (DBA)
  - `organization_country` string, 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
  - `tin` string, required — US Taxpayer Identification Number
  - `foreign_tin` string — Foreign Tax Identification Number
  - `is_ftin_not_legally_required` boolean — Check if FTIN is not legally required
  - `us_business_address` USAddress, required
    - `address1` string, required — Street address
    - `address2` string — Suite/apartment number
    - `city` string, required — City
    - `state` string, required — Two-letter state code
    - `zip_code` string, required — ZIP code (XXXXX or XXXXX-XXXX)
  - `reference_number` string — Reference number for your records
  - `item_of_income` string, required — Description of income items effectively connected with US trade/business
  - `is_dealer_securities_or_ptp` boolean — Is dealer in securities or transferor of PTP interest
  - `signature_name` string, required — Name of the person signing the form

## 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)
