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

# Submit W-8BEN tax form

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

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

## Request body

- W8BENFormRequest
  - `citizen_of_country` string, required — Two-letter country code of citizenship
  - `us_tin_type` 'SSN' | 'ITIN' — Type of US TIN (if applicable)
  - `us_tin` string — US Taxpayer Identification Number (if applicable)
  - `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
  - `tax_treaty_benefits` W8TaxTreatyBenefits
    - `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
  - `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)