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

# Submit W-8IMY tax form

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

This **POST** endpoint is used to submit a W-8IMY tax form (for foreign intermediaries, foreign flow-through entities, or certain U.S. branches) for a specific user identified by their `user_token`. Basic information (name, address, phone) is retrieved from the user's existing profile.

## Request body

- W8IMYFormRequest
  - `disregarded_entity_name` string — Disregarded entity name (if applicable)
  - `chapter_3_status` 'QI_INCLUDING_A_QDD' | 'NONQUALIFIED_INTERMEDIARY' | 'TERRITORY_FINANCIAL_INSTITUTION' | 'US_BRANCH' | 'WITHHOLDING_FOREIGN_PARTNERSHIP' | 'WITHHOLDING_FOREIGN_TRUST' | 'NONWITHHOLDING_FOREIGN_PARTNERSHIP' | 'NONWITHHOLDING_FOREIGN_SIMPLE_TRUST' | 'NONWITHHOLDING_FOREIGN_GRANTOR_TRUST', required — Chapter 3 status for withholding
  - `chapter_4_status` 'NONPARTICIPATING_FFI' | 'PARTICIPATING_FFI' | 'REPORTING_MODEL1_FFI' | 'REPORTING_MODEL2_FFI' | 'REGISTERED_DEEMED_COMPLIANT_FFI' | 'TERRITORY_FINANCIAL_INSTITUTION' | 'SPONSORED_FFI' | 'CERTIFIED_DEEMED_COMPLIANT_NONREGISTERING_LOCAL_BANK' | 'CERTIFIED_DEEMED_COMPLIANT_FFI_WITH_ONLY_LOW_VALUE_ACCOUNTS' | 'CERTIFIED_DEEMED_COMPLIANT_SPONSORED_CLOSELY_HELD_INVESTMENT_VEHICLE' | 'CERTIFIED_DEEMED_COMPLIANT_LIMITED_LIFE_DEBT_INVESTMENT_ENTITY' | 'CERTAIN_INVESTMENT_ENTITIES_THAT_DO_NOT_MAINTAIN_FINANCIAL_ACCOUNTS' | 'OWNER_DOCUMENTED_FFI' | 'RESTRICTED_DISTRIBUTOR' | 'FOREIGN_CENTRAL_BANK_OF_ISSUE' | 'NONREPORTING_IGA_FFI' | 'EXEMPT_RETIREMENT_PLANS' | 'EXCEPTED_NONFINANCIAL_GROUP_ENTITY' | 'EXCEPTED_NONFINANCIAL_START_UP_COMPANY' | 'EXCEPTED_NONFINANCIAL_ENTITY_IN_LIQUIDATION_OR_BANKRUPTCY' | 'PUBLICLY_TRADED_NFFE_OR_NFFE_AFFILIATE_OF_A_PUBLICLY_TRADED_CORPORATION' | 'EXCEPTED_TERRITORY_NFFE' | 'ACTIVE_NFFE' | 'PASSIVE_NFFE' | 'DIRECT_REPORTING_NFFE' | 'SPONSORED_DIRECT_REPORTING_NFFE', required — Chapter 4 (FATCA) status
  - `us_tin_type` 'QI-EIN' | 'WP-EIN' | 'WT-EIN' | 'EIN' — Type of US TIN
  - `us_tin` string — US Taxpayer Identification Number
  - `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
  - `qualified_intermediary` QualifiedIntermediaryInfo
    - `is_qi` boolean — Is a Qualified Intermediary
    - `assumes_primary_withholding_responsibility` boolean — Assumes primary withholding responsibility for chapters 3 and 4
    - `assumes_primary_1446f_responsibility` boolean — Assumes primary withholding for section 1446(f)
    - `assumes_primary_nominee_responsibility` boolean — Assumes primary withholding as nominee
    - `is_qualified_securities_lender` boolean — Is QI acting as qualified securities lender
    - `assumes_primary_1099_reporting` boolean — Assumes primary Form 1099 reporting and backup withholding
    - `does_not_assume_1099_reporting` boolean — Does not assume primary Form 1099 reporting
  - `disregarded_entity_branch` DisregardedEntityBranch
    - `chapter_4_status` string — Chapter 4 status of disregarded entity/branch
    - `address` ForeignAddress
      - `address1` string — Street address
      - `address2` string — Suite/apartment number
      - `city` string — City
      - `state` string — Province or state name
      - `country` string — Two-letter country code
      - `postal_code` string — Postal code
    - `giin` string — GIIN of the disregarded entity/branch
  - `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)